Москва  +7 (495) 120-8115 (с 10 до 18)
Документация для программистов
Ваши сервера (3 обработчика):
Адрес:https://requestb.in/13dxikx1
Состояние:Тестирование начнется через несколько секунд.
Последняя успешная отправка:-
Следующая попытка:-
Адрес:https://requestb.in/13dxikx1
Состояние:Тестирование начнется через несколько секунд.
Последняя успешная отправка:-
Следующая попытка:-
Адрес:http://google.com
Состояние:Тестирование начнется через несколько секунд.
Последняя успешная отправка:-
Следующая попытка:-

Что это?

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

Для работы этой системы, вам необходимо указать адрес скрипта (обработчика), на который мы будем отправлять наши оповещения. Вы можете использовать любой язык программирования. Единственное условие - на любой запрос этот скрипт должен отвечать цифрой 100.

Мы передаем данные в POST формате, в полях data[1], data[2], data[3] .. data[100] — таким образом если вы используете язык PHP, то данные будут доступны для вас в массиве $_POST["data"]. За раз мы передаем не более 100 элементов.

Каждый элемент массива представляет из себя набор текста на нескольких строчках. Первая строчка всегда указывает на тип данных, которые мы вам отправляем.

Какие статусы мы можем отправлять вам в реальном времени

Статус отправленных вами сообщений

sms_status
00000-0000000
103

В данном случае sms_status означает, что отправляется отчет о новом статусе сообщения. На второй строчке указывается идентификатор сообщения, а на третьей строчке - состояние сообщения, согласно api sms/status.

Статус авторизации по звонку

callcheck_status
000000-0000000
402

В данном случае callcheck_status означает, что отправляется отчет о статусе авторизации по звонку. На второй строчке указывается идентификатор авторизации, а на третьей строчке - состояние авторизации, согласно api callcheck.

Пример обработчика на PHP

<?php
foreach ($_POST["data"] as $entry) {
    $lines = explode("\n",$entry);
    switch ($lines[0]) {
        case "sms_status":
            $sms_id = $lines[1];
            $sms_status = $lines[2];

            // "Изменение статуса. Сообщение: $sms_id. Новый статус: $sms_status";
            // Здесь вы можете уже выполнять любые действия над этими данными.
            break;
        case "callcheck_status":
            $check_id = $lines[1];
            $check_status = $lines[2];

            if ($check_status == "401") {
                // Авторизация пройдена успешно. Мы получили звонок с номера, который вы нам передавали.
                // Идентификатор авторизации $check_id (вы должны были сохранить его в вашей базе)
            } elseif ($check_status == "402") {
                // Истекло время, отведенное под авторизацию. Мы не получили звонка с номера, который вы нам передавали
                // Идентификатор авторизации $check_id (вы должны были сохранить его в вашей базе)
            }
            break;
    }
}
echo "100"; /* Важно наличие этого блока, иначе наша система посчитает, что в вашем обработчике сбой */
?>

Если ваш обработчик не возвращает цифру 100, то мы считаем, что либо ваш сервер недоступен, либо в обработчике происходит сбой. В обоих случаях, любая доставка оповещений в реальном времени прекращается и мы начинаем повторную отправку каждые 60 секунд (до 5 дней).

Бесплатный номер по России  +7 (800) 222-60-95