• Главная
  • Тарифы
  • Подключение (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)

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

    РАЗНОЕ

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

    В случае ошибки Сервер возвращает следующую строку:
    • 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Неверный логин или пароль.
    3Имя отправителя не найдено.
    4IP-адрес временно заблокирован.
    5Ошибка сохранения или удаления имени отправителя.
    7Неверный формат номера.
    8Код подтверждения на указанный номер не может быть доставлен.
    9Попытка отправки более трех одинаковых запросов на получение списка доступных имен отправителей или пяти запросов на создание нового имени отправителя в течение минуты.
    10Код уже был отправлен на указанный номер. Повторная попытка возможна через 8 часов.
    11Неверный код подтверждения.

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

    При запросе списка имен отправителей:
    • при fmt = 0 и all = 0:
      name = <sender>
      ...

    • при fmt = 1 и all = 0:
      <sender>
      ...

    • при fmt = 2 и all = 0:
      <list>
      <sender>sender</sender>
      ...
      </list>

    • при fmt = 3 и all = 0:
      [{
      "sender": "<sender>"
      },
      ...]

    • при fmt = 0 и all = 1:
      name = <sender>, status = <status>
      ...

    • при fmt = 1 и all = 1:
      <sender>,<status>
      ...

    • при fmt = 2 и all = 1:
      <list>
      <sender status="<status>">sender</sender>
      ...
      </list>

    • при fmt = 3 и all = 1:
      [{
      "sender": "<sender>",
      "status": <status>
      },
      ...]

    • при fmt = 0 и operators = 1:
      name = <sender>, mega = <mega_status>, mts = <mts_status>, mega_step = <mega_step_status>, bee_step = <bee_step_status>, motiv_step = <motiv_step_status>, mts_step = <mts_step_status>, tele2_step = <tele2_step_status>, tele2 = <tele2_status>, ua_reg = <ua_reg_status>, ua_int = <ua_int_status>
      ...

    • при fmt = 1 и operators = 1:
      <sender>,<mega_status>,<mts_status>,<mega_step_status>,<bee_step_status>,<motiv_step_status>,<mts_step_status>,<tele2_step_status>, <tele2_status>,<ua_reg_status>,<ua_int_status>
      ...

    • при fmt = 2 и operators = 1:
      <list>
      <sender mega="<mega_status>" mts="<mts_status>" mega_step="<mega_step_status>" bee_step="<bee_step_status>" motiv_step="<motiv_step_status>" mts_step="<mts_step_status>" tele2_step="<tele2_step_status>" tele2="<tele2_status>" ua_reg="<ua_reg_status>" ua_int="<ua_int_status>">sender</sender>
      ...
      </list>

    • при fmt = 3 и operators = 1:
      [{
      "sender": "<sender>",
      "mega": "<mega_status>",
      "mts": "<mts_status>",
      "mega_step": "<mega_step_status>",
      "bee_step": "<bee_step_status>",
      "motiv_step": "<motiv_step_status>",
      "mts_step": "<mts_step_status>",
      "tele2_step": "<tele2_step_status>",
      "tele2": "<tele2_status>",
      "ua_reg": "<ua_reg_status>",
      "ua_int": "<ua_int_status>"
      },
      ...]

    Где:
    <sender> – зарегистрированное и допущенное к использованию имя отправителя.
    <mega_status>, <mts_status>, <mega_step_status>, <bee_step_status>, <motiv_step_status>, <mts_step_status>, <tele2_step_status>, <tele2_status>, <ua_reg_status>, <ua_int_status> – код статуса имени отправителя у соответствующего оператора (0 - ожидает регистрации, 1 - отправлено на регистрацию, 2 - допущено оператором, 3 - не принято оператором, 4 - временно отключено, 5 - автоотключение из-за окончания баланса, 6 - дубль другого имени (конфликт)).
    <status> – статус имени отправителя (0 - ожидает модерации, 1 - допущено к использованию, 2 - выключено).

    При добавлении нового имени отправителя:
    • при fmt = 0: ID = <id>

    • при fmt = 1: <id>

    • при fmt = 2:
      <sender>
      <id>id</id>
      </sender>

    • при fmt = 3:
      {
      "sender": <id>
      }

    Где:
    <id> – идентификатор имени отправителя, назначенный Сервером автоматически.

    При изменении имени отправителя, отправке кода, подтверждении и удалении имени отправителя:
    • при fmt = 0, 1: OK

    • при fmt = 2:
      <result>OK</result>

    • при fmt = 3:
      {
      "result": "OK"
      }





    =100% cellpadding=0>Изменение условий работы на отправку SMS-сообщений в сеть оператора Т2 (Россия)25.02.2025с 1 марта меняются условия работы на отправку SMS-сообщений в сеть оператора Т2 (Россия). С указанной даты оператор вводит обязательную бесплатную регистрацию имени отправителя. Сообщения, без зарегистрированного имени у клиента, будут блокироваться. Подать имя отправителя на регистрацию можно в личном кабинете, меню Настройки - Имена отправителей.