Тарифы  Услуги  API  ПARTNERS  О сервисе  КONTACTS 
8 (800) 700 7672
БFOR FREE IN RUSSIA
 

ИINTEGRATION WITH THE SERVICE (API)

THE API ALLOWS YOU TO SEND MESSAGES THROUGH YOUR PROJECTS AND SERVICES USING HTTP/HTTPS, SMTP, AND SMPP PROTOCOLS. READY-MADE LIBRARIES IN DIFFERENT PROGRAMMING LANGUAGES CONNECT TO YOUR PROJECT AND HELP YOU SEND MESSAGES FROM ANYWHERE WITH A SINGLE COMMAND. FOR SIMPLIFIED AUTHORIZATION, INSTEAD OF A LOGIN AND PASSWORD PAIR, YOU CAN USE A SPECIAL API KEY..


HTTP/HTTPS SMTP SMPP SOAP OMS SMS Commands Libraries and code examples

ОSENDING MESSAGES

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

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

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

ОSENDING AN HLR REQUEST

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

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

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

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

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

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

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

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

Управление шаблонами операторов

ВPUNCTUAL SHIPPING (TESTING MODE)

УREFLECTIONS ON THE EVENTS

УMAILING LIST MANAGEMENT

СMESSAGE STATUSES

Проверка состояния баланса

УMANAGING CONTACTS

УCUSTOMER MANAGEMENT

Управление именами отправителей (SENDER ID)

ПDATA EXCLUSION

РAZNOE

Входящие сообщения HTTP

Для получения списка входящих сообщений необходимо вызвать методом GET или POST адрес: https://smscentre.com/sys/get.php?get_answers=1&login=<login>&psw=<password>
Описание параметров, передаваемых Серверу:

ПARAMETERЗTHE BEGINNING
loginЛCLIENT'S LOGIN.
pswПCUSTOMER'S AROL (you can add or change it on this page.).
apikeyСA SPECIAL API KEY USED FOR SIMPLIFIED AUTHORIZATION INSTEAD OF A LOGIN+PASSWORD PAIR (можно создать на данной странице).
cntКоличество возвращаемых в ответе сообщений. Максимальное значение равно 10000.
hourПериод в часах, за который необходимо запросить входящие сообщения. Максимальное количество часов - 168 (7 DAYS).
after_idИдентификатор сообщения, начиная с которого необходимо вернуть входящие сообщения, за исключением самого after_id.
to_phoneНомер телефона Клиента, на который получены входящие сообщения.

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

  • Пri fmt = 1:
    0,-N

  • Пri fmt = 2:
    <result>
    <error>DESCRIPTION</error>
    <error_code>N</error_code>
    </result>

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

ЗTHE BEGINNINGОTHE SCRIPTURE
1ОERROR IN PARAMETERS.
2Нyour username or password. It also occurs when trying to send a message from an IP address that is not included in the list allowed by the Client. (если такой список был настроен Клиентом ранее).
4IP-адрес временно заблокирован.
9ПTHE EXPERIENCE OF SENDING MORE THAN THREE IDENTICAL REQUESTS FOR A LIST OF INCOMING MESSAGES WITHIN A MINUTE.
ДTHIS ERROR ALSO OCCURS WHEN TRYING TO SEND FIFTEEN OR MORE REQUESTS SIMULTANEOUSLY FROM DIFFERENT CONNECTIONS UNDER THE SAME USERNAME. (too many concurrent requests).

В случае успешного запроса Сервер возвращает ответ в виде строки:
  • with fmt = 0:
    id = <id>, received = <received>, phone = <phone>, message = <message>, to_phone = <to_phone>, sent = <sent>
    ...

  • with fmt = 1:
    <id>,<received>,<phone>,<to_phone>,<sent>,<message>
    ...

  • with fmt = 2:
    <sms_answers>
    <sms>
    <id>id</id>
    <received>received</received>
    <phone>phone</phone>
    <message>message</message>
    <to_phone>to_phone</to_phone>
    <sent>sent</sent>
    </sms>
    ...
    </sms_answers>

  • with fmt = 3:
    [{
    "id": <id>,
    "received": "<received>",
    "phone": "<phone>",
    "message": "<message>",
    "to_phone": "<to_phone>",
    "sent": "<sent>"
    },
    ...]

ГDE:
<id> – идентификатор входящего сообщения, назначаемый Сервером автоматически.
<received> – дата получения сообщения Сервером. Формат DD.MM.YYYY hh:mm:ss.
<phone> – номер телефона абонента.
<message> – входящее сообщение.
<to_phone> – номер телефона получателя.
<sent> – дата отправки сообщения. Формат DD.MM.YYYY hh:mm:ss.


ПREAMERS:

Получение списка из 10 первых входящих сообщений за текущие сутки:

https://smscentre.com/sys/get.php?get_answers=1&login=alex&psw=123&cnt=10
Получение списка из 15 первых входящих сообщений за последние 48 часов:

https://smscentre.com/sys/get.php?get_answers=1&login=alex&psw=123&hour=48&cnt=15
Получение списка из 20 первых входящих сообщений с идентификаторами, большими id="1234567":

https://smscentre.com/sys/get.php?get_answers=1&login=alex&psw=123&after_id=1234567&cnt=20

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