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

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

    РАЗНОЕ

    Подключение выделенных номеров для приема сообщений

    Вы можете через специальные команды API получать список свободных выделенных номеров для приема SMS-сообщений и подключать любой номер к своему логину, оплачивая стоимость за остаток дней в текущем месяце. При подключении выделенного номера вы автоматически соглашаетесь с правилами использования таких номеров.

    Для получения списка доступных выделенных номеров необходимо вызвать методом GET или POST следующий адрес: http://billing.smstraf.ru/sys/receive_phones.php?get=1&login=<login>&psw=<password>
    Для подключения выделенного номера необходимо вызвать методом GET или POST адрес: http://billing.smstraf.ru/sys/receive_phones.php?buy=1&login=<login>&psw=<password>&phone=<phone>
    Для изменения признака продления выделенного номера на следующий месяц необходимо вызвать методом GET или POST адрес: http://billing.smstraf.ru/sys/receive_phones.php?chg=1&login=<login>&psw=<password>&phone=<phone>&noprolong=<noprolong>
    Описание параметров, передаваемых Серверу:

    ПараметрЗначение
    loginЛогин Клиента.
    pswПароль Клиента или MD5-хеш пароля в нижнем регистре.
    phoneПодключаемый номер.
    noprolongПризнак продления выделенного номера на следующий месяц. Данный параметр также возможно указывать при подключении номера в команде buy.
    0 (по умолчанию) – включить автоматическое продление номера.
    1 – отключить автоматическое продление номера.

    В случае ошибки Сервер возвращает следующую строку:
    • 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-адрес временно заблокирован.
    9Попытка отправки более двух одинаковых запросов на получение списка доступных для аренды номеров или подключение номера, либо изменение свойств выделенного номера в течение минуты.

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

    Для получения списка доступных номеров:
    • при fmt = 0:
      phone = <phone>, type = <type>, cost = <cost>, current_cost = <current_cost>, info = <info>
      ...

    • при fmt = 1:
      <phone>,<type>,<cost>,<current_cost>,<info>
      ...

    • при fmt = 2:
      <list>
      <receive_phone>
      <phone>phone</phone>
      <type>type</type>
      <cost>cost</cost>
      <current_cost>current_cost</current_cost>
      <info>info</info>
      </receive_phone>
      ...
      </list>

    • при fmt = 3:
      [{
      "phone": "<phone>",
      "type": <type>,
      "cost": "<cost>",
      "current_cost": "<current_cost>"
      "info": "<info>"
      },
      ...]

    Где:
    <phone> – номер телефона.
    <type> – тип номера: 1,4 – выделенный виртуальный номер, 2 – номер на услуге SIM-хостинга.
    <cost> – стоимость аренды номера за полный месяц.
    <current_cost> – стоимость аренды номера за остаток дней до конца текущего месяца.
    <info> – название оператора и поддерживаемые типы уведомлений.

    Для аренды номера:
    • при fmt = 0: cost = <cost>

    • при fmt = 1: <cost>

    • при fmt = 2:
      <phone>
      <cost>cost</cost>
      </phone>

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

    Где:
    <cost> – сумма, списанная со счета Клиента за аренду номера.

    Для изменения признака продления номера:
    • при fmt = 0,1: OK

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

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



    Примеры:

    Получение списка свободных номеров для аренды:

    http://billing.smstraf.ru/sys/receive_phones.php?get=1&login=alex&psw=123
    Подключение номера "79999999999":

    http://billing.smstraf.ru/sys/receive_phones.php?buy=1&login=alex&psw=123&phone=79999999999
    Отключение возможности продления выделенного номера "79999999999" на следующий месяц:

    http://billing.smstraf.ru/sys/receive_phones.php?chg=1&login=alex&psw=123&phone=79999999999&noprolong=1

    Сервер не принимает более двух одинаковых запросов в течение минуты на получение списка свободных для аренды номеров или подключение номера, либо изменение свойств выделенного номера для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.




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