SMS API

GET API

Отправка SMS через HTTP GET с возвратом ID сообщения, стоимости и остатка баланса.

Источник: спецификация от 01.01.2025Ответ с ID сообщения

Отправка SMS

HTTP-метод: GET

Действующий адрес: https://sms.papamedia.ru/sendsms.php

Не заменяйте домен автоматическиДля входа в кабинет используется https://sms.mediarik.ru, но поддержку GET API на новом домене ещё предстоит проверить. До отдельного подтверждения используйте адрес API из этой инструкции.

Пример запроса с безопасными обозначениями

https://sms.papamedia.ru/sendsms.php
  ?login=YOUR_LOGIN
  &password=YOUR_PASSWORD
  &sadr=YOUR_SENDER
  &dadr=79991234567
  &text=Текст%20сообщения

Параметры

Исходная спецификация не помечает каждый параметр как обязательный или необязательный. Ниже отдельно отмечено, что присутствует в базовом примере запроса.

Параметр	В базовом примере	Описание
`login`	Да	Логин пользователя. В спецификации также указаны альтернативы с токеном.
`password`	Да	Пароль пользователя.
`token`	Альтернатива	Токен пользователя вместо пары логин и пароль.
`token_hash`	Альтернатива	Токен в формате MD5 вместе с логином — согласно исходной спецификации.
`sadr`	Да	Имя отправителя.
`dadr`	Да	Номер получателя; несколько адресов перечисляются через запятую.
`text`	Да	Текст SMS.
`validity_period`	Нет	Срок жизни сообщения в формате `YYYY-MM-DD HH:MM`.
`additional_info_1…5`	Нет	Дополнительные поля.

Ответ на отправку

JSON

{
  "information": [
    {"id_message": "123456", "price": "..."}
  ],
  "balance": "..."
}

Поле	Тип	Описание
`id_message`	Int	ID сообщения для проверки статуса.
`price`	Double	Стоимость сообщения.
`balance`	Double	Баланс в кабинете.

Проверка статуса

Статус запрашивается по полученному id_message.

GET

https://sms.papamedia.ru/sendsms.php
  ?login=YOUR_LOGIN
  &password=YOUR_PASSWORD
  &id_message=123456

Статус	Значение по спецификации
`send`	Статус ещё не получен.
`deliver`	Сообщение доставлено.
`not_deliver`	Сообщение не доставлено; конечный статус.
`expired`	Истёк срок доставки; конечный статус.
`read`	Сообщение прочитано; конечный статус.
`partly_deliver`	Сообщение отправлено, но окончательный статус не получен.

Поле error может содержать причину недоставки, например недопустимый номер, недоступное имя отправителя или недостаток средств.

Проверка баланса

GET

https://sms.papamedia.ru/sendsms.php
  ?login=YOUR_LOGIN
  &password=YOUR_PASSWORD
  &balance=1

В ответе используется поле balance типа double.