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

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

    РАЗНОЕ

    Запрос тарифов

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

    ПараметрЗначение
    loginЛогин Клиента.
    pswПароль Клиента или MD5-хеш пароля в нижнем регистре.

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

    В случае успешного запроса Сервер возвращает ответ в виде набора строк:
    • при fmt = 0:
      zone = <zone>, name = <name>, api = <api>, mass = <mass>, mms = <mms>, hlr = <hlr>, call = <call>
      ...

      при наличии установленных индивидуальных тарифов по определенным операторам к ответу добавляется набор строк:
      mccmnc = <mccmnc>, cost = <cost>
      ...

      mail = <mail>

    • при fmt = 1:
      <zone>,<name>,<api>,<mass>,<mms>,<hlr>,<call>
      ...

      <mccmnc>,<cost>
      ...

      <mail>

    • при fmt = 2:
      <price>
      <zones>
      <zone name="<name>" api="<api>" mass="<mass>" mms="<mms>" hlr="<hlr>" call="<call>">zone</zone>
      ...
      </zones>
      <codes>
      <mccmnc cost="<cost>">mccmnc</mccmnc>
      ...
      </codes>
      <mail>mail</mail>
      </price>

    • при fmt = 3:
      {
      "zones": [{
      "zone": "<zone>",
      "name": "<name>",
      "api": "<api>",
      "mass": "<mass>",
      "mms": "<mms>",
      "hlr": "<hlr>",
      "call": "<call>"
      },
      ...
      {
      ...
      }],
      "codes": [{
      "mccmnc": "<mccmnc>",
      "cost": "<cost>"
      },
      ...
      {
      ...
      }],
      "mail": "<mail>"
      }

    Где:
    <zone> - тарифная зона.
    <name> - название тарифной зоны (оператор, страна и т.п.).
    <api> - стоимость SMS при отправке через API.
    <mass> - стоимость SMS при отправке через личный кабинет.
    <mms> - стоимость MMS-сообщения.
    <hlr> - стоимость HLR-запроса.
    <call> - стоимость голосового сообщения (звонок).
    <mccmnc> - код страны и мобильного оператора, для которого установлен индивидуальный тариф.
    <cost> - стоимость сообщения по данному индивидуальному тарифу.
    <mail> - стоимость e-mail сообщения.

    Примеры:

    Получение списка тарифов:

    http://billing.smstraf.ru/sys/get.php?get_price=1&login=alex&psw=123

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




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