При различного рода операциях, таких как восстановление паролей, авторизация в общественных сетях Wi-Fi, подтверждение денежных переводов, вход в личный кабинет и так далее требуется отправка аутентификационных данных. Используя наш API можно организовать процедуру подтверждения номера телефона с помощью звонка самим абонентом.
Для создания запроса на получение номера телефона, по которому абонент должен будет осуществить подтверждающий звонок, необходимо вызвать методом GET или POST адрес:
http://my.smsc.dp.ua/sys/wait_call.php?login=<login>&psw=<password>&phone=<phone>
Серверу передаются следующие параметры:
Параметр
Значение
login
Логин Клиента.
psw
Пароль Клиента (можно добавить или изменить на данной странице).
phone
Номер телефона абонента, с которого будет осуществлен подтверждающий звонок.
В случае ошибки Сервер возвращает следующую строку:
N – номер ошибки, может принимать следующие значения:
Значение
Описание
1
Ошибка в параметрах.
2
Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
3
Недостаточно средств на счете Клиента.
4
IP-адрес временно заблокирован.
5
Указанный номер телефона абонента находится в черном списке Клиента.
9
Попытка отправки более пятидесяти одинаковых запросов на получение номера телефона для подтверждения в течение минуты.
Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).
В случае успешного запроса Сервер возвращает ответ в виде строки.
при fmt = 0 и fmt = 1:
<phone>
при fmt = 2:
<phone>phone</phone>
при fmt = 3:
{
"phone": "<phone>"
}
Где: <phone> – номер телефона, на который в течение 15 минут должен осуществить звонок абонент для подтверждения своего номера телефона.
После звонка абонента Сервер зафиксирует факт звонка в виде входящего сообщения с текстом "[waitcall]" и отправит на обработчик Клиента всю необходимую информацию о данном звонке.
Сервер не принимает более пятидесяти одинаковых запросов на получение номера телефона для подтверждения в течение минуты для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.
Подтверждение номера телефона с помощью звонка