API: Авторизация
вернуться на главную
Для корректной работы модуля “Авторизация”, сайт должен отправлять на URL API коды подтверждения, для каждого телефона индивидуально.
Например, ваш новый пользователь, решил пройти регистрацию на сайте. После ввода телефона, сайт должен отправить на URL API следующие данные:
- Телефон клиента, в формате:
- 70000000000 (Россия);
- 994000000000 (Азербайджан);
- 37400000000 (Армения);
- 375000000000 (Беларусь);
- 995000000000 (Грузия);
- 70000000000 (Казахстан);
- 996000000000 (Киргизия);
- 37300000000 (Молдова);
- 992000000000 (Таджикистан);
- 998000000000 (Узбекистан);
- 380000000000 (Украина).
- Код подтверждения, в формате: 9999 (4 цифры);
- ID бота.
После получения положительного ответа от API, сайт сообщает пользователю, что код был отправлен в WhatsApp, или что бы он получил код подтверждения в Телеграм-боте, а затем ввел его в поле, на сайте.
Код подтверждения для каждого номера сохраняется в течение 24 часов, а затем удаляется.
URL API
Переменные в URL API:
{api_key} - ваш API ключ из раздела Личные данные;
{phone} - телефон клиента;
{code} - код подтверждения клиента;
{bot_id} - ID бота.
{phone} - телефон клиента;
{code} - код подтверждения клиента;
{bot_id} - ID бота.
Пример успешного ответа (JSON):
{“status”:1}
Пример ответа c ошибкой (JSON):
{“status”:0, “code”:24, “error”:”API ключ указан неверно”}
Пример запроса на PHP:
$key = '9536b5ba8ad6c038209948d8c6b9ec47632d535e8b2457039b21582d4bae1fbd';
$phone = '79000000001';
$code = '1234';
$bot_id = 'S1-4321';
$r = file_get_contents('https://ityman.ru/api/activation?key='.$key.'&phone='.$phone.'&code='.$code.'&bot_id='.$bot_id);
$result = json_decode($r, true);
if($result['status'] != 1){
print 'Ошибка: '.$result['error'];
}
$phone = '79000000001';
$code = '1234';
$bot_id = 'S1-4321';
$r = file_get_contents('https://ityman.ru/api/activation?key='.$key.'&phone='.$phone.'&code='.$code.'&bot_id='.$bot_id);
$result = json_decode($r, true);
if($result['status'] != 1){
print 'Ошибка: '.$result['error'];
}
Коды ошибок:
{“status”:0, “code”:1, “error”:”Переданы не все обязательные поля”}
{“status”:0, “code”:2, “error”:”Ключ указан неверно”}
{“status”:0, “code”:3, “error”:”Логин или пароль указаны неверно”}
{“status”:0, “code”:4, “error”:”Аккаунт заблокирован. Закончился оплаченный период.”}
{“status”:0, “code”:5, “error”:”Бот не найден или удален”}
{“status”:0, “code”:7, “error”:”Сообщение WhatsApp не отправлено. Пользователь не зарегистрирован, или номер сформирован неправильно. Поддерживаются только номера в международном формате. Пример для России: 79999999999.”}
{“status”:0, “code”:50, “error”:”Неверно указано поле BOT ID”}
{“status”:0, “code”:2, “error”:”Ключ указан неверно”}
{“status”:0, “code”:3, “error”:”Логин или пароль указаны неверно”}
{“status”:0, “code”:4, “error”:”Аккаунт заблокирован. Закончился оплаченный период.”}
{“status”:0, “code”:5, “error”:”Бот не найден или удален”}
{“status”:0, “code”:7, “error”:”Сообщение WhatsApp не отправлено. Пользователь не зарегистрирован, или номер сформирован неправильно. Поддерживаются только номера в международном формате. Пример для России: 79999999999.”}
{“status”:0, “code”:50, “error”:”Неверно указано поле BOT ID”}
Дополнительно:
{“status”:1, “code”:6, “info”:”Код принят, но телеграм-пользователь с таким номером не найден”}