• Главная
  • Тарифы
  • Подключение (API)
  • Вопросы (FAQ)
  • Новости
  • Договор
  • Контакты
  • Вход

    • API / HTTP/HTTPS протокол / Ответ сервера и коды ошибок

    API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.


    HTTP/HTTPS SMTP SMPP SOAP SMS-команды Библиотеки и примеры кода

    ОТПРАВКА СООБЩЕНИЙ

    Отправка SMS-сообщения

    Комментарии в SMS-сообщениях

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

    Отправка HLR-запроса

    Отправка MMS-сообщения

    Отправка e-mail сообщения

    Отправка голосового сообщения (звонок)

    Отправка viber-сообщения

    Использование префиксов при отправке сообщений

    Управление шаблонами сообщений

    Виртуальная отправка (режим тестирования)

    УПРАВЛЕНИЕ РАССЫЛКАМИ

    СТАТУСЫ СООБЩЕНИЙ

    ПРОВЕРКА СОСТОЯНИЯ БАЛАНСА

    УПРАВЛЕНИЕ КОНТАКТАМИ

    УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)

    ПОЛУЧЕНИЕ ДАННЫХ

    РАЗНОЕ

    Ответ сервера и коды ошибок

    В случае ошибки Сервер возвращает следующую строку:
    • При fmt = 0:
      ERROR = N (описание)

    • При fmt = 1:
      0,-N

    • При fmt = 2:
      <result>
      <error>описание</error>
      <error_code>N</error_code>
      </result>

    • При fmt = 3:
      {
      "error": "описание",
      "error_code": N
      }
    N – номер ошибки, может принимать следующие значения:

    ЗначениеОписание
    1Ошибка в параметрах.
    2Неверный логин или пароль.
    4IP-адрес временно заблокирован.
    5Ошибка удаления сообщения.
    9Попытка отправки более пяти запросов на получение статуса одного и того же сообщения в течение минуты.

    В случае успешного запроса Сервер возвращает ответ в виде строки:

    Ответы для SMS-сообщений:
    • при fmt = 0 и all = 0: Status = <status>, check_time = <last_date>, err = <err>

    • при fmt = 1 и all = 0: <status>,<last_timestamp>,<err>

    • при fmt = 2 и all = 0:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      </sms>

    • при fmt = 3 и all = 0:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>
      }

    • при fmt = 0 и all = 1:
      Status = <status>, check_time = <last_date>, err = <err>, send_date = <send_date>, phone = <phone>, cost = <cost>, sender_id = <sender>, status_name = <status_name>, message = <message>, type = <type>

    • при fmt = 1 и all = 1:
      <status>,<last_timestamp>,<err>,<send_timestamp>,<phone>,<cost>,<sender>,<status_name>,<message>,<type>

    • при fmt = 2 и all = 1:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <send_date>send_date</send_date>
      <send_timestamp>send_timestamp</send_timestamp>
      <phone>phone</phone>
      <cost>cost</cost>
      <sender_id>sender</sender_id>
      <status_name>status_name</status_name>
      <message>message</message>
      <type>type</type>
      </sms>

    • при fmt = 3 и all = 1:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "send_date": "<send_date>",
      "send_timestamp": <send_timestamp>,
      "phone": "<phone>",
      "cost": "<cost>",
      "sender_id": "<sender>",
      "status_name": "<status_name>",
      "message": "<message>",
      "type": <type>
      }

    • при fmt = 0 и all = 2:
      Status = <status>, check_time = <last_date>, err = <err>, send_date = <send_date>, phone = <phone>, country = <country>, operator = <operator>, region = <region>, cost = <cost>, sender_id = <sender>, status_name = <status_name>, message = <message>, type = <type>

    • при fmt = 1 и all = 2:
      <status>,<last_timestamp>,<err>,<send_timestamp>,<phone>,<country>,<operator>,<region>,<cost>,<sender>,<status_name>,<message,<type>

    • при fmt = 2 и all = 2:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <send_date>send_date</send_date>
      <send_timestamp>send_timestamp</send_timestamp>
      <phone>phone</phone>
      <cost>cost</cost>
      <sender_id>sender</sender_id>
      <status_name>status_name</status_name>
      <message>message</message>
      <country>country</country>
      <operator>operator</operator>
      <region>region</region>
      <type>type</type>
      </sms>

    • при fmt = 3 и all = 2:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "send_date": "<send_date>",
      "send_timestamp": <send_timestamp>,
      "phone": "<phone>",
      "cost": "<cost>",
      "sender_id": "<sender>",
      "status_name": "<status_name>",
      "message": "<message>",
      "country": "<country>",
      "operator": "<operator>",
      "region": "<region>",
      "type": <type>
      }
    Где:
    <status> – код статуса (список)
    <last_date> – дата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
    <last_timestamp> – штамп времени последнего изменения статуса.
    <err> – код ошибки, если сообщение не было доставлено.
    <send_date> – дата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
    <send_timestamp> – штамп времени отправки сообщения.
    <phone> – номер телефона абонента или e-mail адрес.
    <country> – название страны регистрации номера абонента.
    <operator> – название оператора абонента.
    <region> – регион регистрации номера абонента.
    <cost> – стоимость сообщения.
    <sender> – имя отправителя.
    <status_name> – название статуса.
    <message> – текст сообщения.
    <type> – тип сообщения (0 – SMS, 1 – Flash-SMS, 2 – Бинарное SMS, 3 – Wap-push, 4 – HLR-запрос, 5 – Ping-SMS, 6 – MMS, 7 – Звонок, 10 – Viber).

    Ответы для HLR-запросов:
    • при fmt = 0 и all = 0:
      Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>, msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet>

    • при fmt = 1 и all = 0: <status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>

    • при fmt = 2 и all = 0:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <imsi>imsi</imsi>
      <msc>msc</msc>
      <mcc>mcc</mcc>
      <mnc>mnc</mnc>
      <cn>cn</cn>
      <net>net</net>
      <rcn>rcn</rcn>
      <rnet>rnet</rnet>
      </sms>

    • при fmt = 3 и all = 0:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "imsi": "<imsi>",
      "msc": "<msc>",
      "mcc": "<mcc>",
      "mnc": "<mnc>",
      "cn": "<cn>",
      "net": "<net>",
      "rcn": "<rcn>",
      "rnet": "<rnet>"
      }

    • при fmt = 0 и all = 1:
      Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>, msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet>, send_date = <send_date>, phone = <phone>, cost = <cost>, sender_id = <sender_id>, status_name = <status_name>, message = <message>, type = <type>

    • при fmt = 1 и all = 1:
      <status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>, <send_timestamp>,<phone>,<cost>,<sender_id>,<status_name>,<message>,<type>

    • при fmt = 2 и all = 1:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <imsi>imsi</imsi>
      <msc>msc</msc>
      <mcc>mcc</mcc>
      <mnc>mnc</mnc>
      <cn>cn</cn>
      <net>net</net>
      <rcn>rcn</rcn>
      <rnet>rnet</rnet>
      <send_date>send_date</send_date>
      <send_timestamp>send_timestamp</send_timestamp>
      <phone>phone</phone>
      <cost>cost</cost>
      <sender_id>sender_id</sender_id>
      <status_name>status_name</status_name>
      <message>message</message>
      <type>type</type>
      </sms>

    • при fmt = 3 и all = 1:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "imsi": "<imsi>",
      "msc": "<msc>",
      "mcc": "<mcc>",
      "mnc": "<mnc>",
      "cn": "<cn>",
      "net": "<net>",
      "rcn": "<rcn>",
      "rnet": "<rnet>",
      "send_date": "<send_date>",
      "send_timestamp": <send_timestamp>,
      "phone": "<phone>",
      "cost": "<cost>",
      "sender_id": "<sender>",
      "status_name": "<status_name>",
      "message": "<message>",
      "type": <type>
      }

    • при fmt = 0 и all = 2:
      Status = <status>, check_time = <check_time>, err = <err>, imsi = <imsi>, msc = <msc>, mcc = <mcc>, mnc = <mnc>, cn = <cn>, net = <net>, rcn = <rcn>, rnet = <rnet>, send_date = <send_date>, phone = <phone>, country = <country>, operator = <operator>, region = <region>, cost = <cost>, sender_id = <sender_id>, status_name = <status_name>, message = <message>, type = <type>

    • при fmt = 1 и all = 2:
      <status>,<last_timestamp>,<err>,<imsi>,<msc>,<mcc>,<mnc>,<cn>,<net>,<rcn>,<rnet>, <send_timestamp>,<phone>,<country>,<operator>,<region>,<cost>,<sender_id>,<status_name>,<message>,<type>

    • при fmt = 2 и all = 2:
      <sms>
      <status>status</status>
      <last_date>last_date</last_date>
      <last_timestamp>last_timestamp</last_timestamp>
      <err>err</err>
      <imsi>imsi</imsi>
      <msc>msc</msc>
      <mcc>mcc</mcc>
      <mnc>mnc</mnc>
      <cn>cn</cn>
      <net>net</net>
      <rcn>rcn</rcn>
      <rnet>rnet</rnet>
      <send_date>send_date</send_date>
      <send_timestamp>send_timestamp</send_timestamp>
      <phone>phone</phone>
      <cost>cost</cost>
      <sender_id>sender_id</sender_id>
      <status_name>status_name</status_name>
      <message>message</message>
      <country>country</country>
      <operator>operator</operator>
      <region>region</region>
      <type>type</type>
      </sms>

    • при fmt = 3 и all = 2:
      {
      "status": <status>,
      "last_date": "<last_date>",
      "last_timestamp": <last_timestamp>,
      "err": <err>,
      "imsi": "<imsi>",
      "msc": "<msc>",
      "mcc": "<mcc>",
      "mnc": "<mnc>",
      "cn": "<cn>",
      "net": "<net>",
      "rcn": "<rcn>",
      "rnet": "<rnet>",
      "send_date": "<send_date>",
      "send_timestamp": <send_timestamp>,
      "phone": "<phone>",
      "cost": "<cost>",
      "sender_id": "<sender>",
      "status_name": "<status_name>",
      "message": "<message>",
      "country": "<country>",
      "operator": "<operator>",
      "region": "<region>",
      "type": <type>
      }

    Где:
    <status> – код статуса (список)
    <last_date> – дата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
    <last_timestamp> – штамп времени последнего изменения статуса.
    <err> – код HLR-ошибки или статуса абонента (список).
    <imsi> – уникальный код IMSI SIM-карты абонента.
    <msc> – номер сервис-центра оператора, в сети которого находится абонент.
    <mcc> – числовой код страны абонента.
    <mnc> – числовой код оператора абонента.
    <cn> – название страны регистрации абонента.
    <net> – название оператора регистрации абонента.
    <rcn> – название роуминговой страны абонента при нахождении в чужой сети.
    <rnet> – название роумингового оператора абонента при нахождении в чужой сети.
    <send_date> – дата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
    <send_timestamp> – штамп времени отправки сообщения.
    <phone> – номер телефона абонента.
    <country> – название страны регистрации номера абонента.
    <operator> – название оператора абонента.
    <region> – регион регистрации номера абонента.
    <cost> – стоимость сообщения.
    <sender> – имя отправителя.
    <status_name> – название статуса.
    <message> – текст сообщения.
    <type> – тип сообщения (для HLR равен 4).

    Если сообщение не найдено или находится в архивной базе (значение статуса равно -3), то для fmt = 0,2,3 возвращается код статуса в соответствующем формате. Для fmt = 1 возвращается ответ в формате статуса обычного сообщения.

    При множественном запросе статусов:
    • для fmt = 0 и fmt = 1 в результате возвращается список строк, каждая из которых содержит информацию о статусе соответствующего сообщения.
    • для fmt = 2 формат возвращаемых статусов аналогичен формату для одиночных сообщений, при этом весь список статусов заключается в тег "<list>".
    • для fmt = 3 формат также аналогичен формату для одиночных сообщений, статусы перечисляются через запятую, и весь список обрамляется квадратными скобками.
    В случае множественного запроса статусов при значении параметра all = 1 или all = 2 для каждого статуса дополнительно возвращается идентификатор сообщения. При all = 0 дополнительно возвращается идентификатор сообщения и номер телефона.



    Изменение тарифов на выполнение HLR-запросов в сеть оператора МТС (Россия)
    26.02.2025
    С 1 марта повышаются цены на отправку HLR-запросов абонентам оператора связи МТС (Россия). Новые тарифы указаны на сайте на странице .