API: Уведомления
вернуться на главную
Для работы с уведомлениями, вы должны создать шаблоны уведомлений в личном кабинете, в разделе "Уведомления". У каждого уведомления существует свой уникальный ID. Этот ID понадобится для отправки этого уведомления клиенту.
Для отправки уведомления клиенту, вы должны послать GET запрос на URL API со следующей информацией:
- Телефон клиента, в формате: 79000000000 (11 цифр);
- ID уведомления.
Если все переменные заполнены корректно, пользователь моментально получит уведомление в Телеграм.
URL API
Переменные в URL API:
{api_key} - ваш API ключ из раздела Личные данные;
{phone} - телефон клиента;
{id} - ID уведомления в системе;
{phone} - телефон клиента;
{id} - ID уведомления в системе;
Пример успешного ответа (JSON):
{“status”:1}
Пример ответа c ошибкой (JSON):
{“status”:0, “code”:21, “error”:”уведомления с таким id не существует”}
Пример запроса на PHP:
$key = '9536b5ba8ad6c038209948d8c6b9ec47632d535e8b2457039b21582d4bae1fbd';
$phone = '79000000001';
$id = 'S1-12';
$r = file_get_contents('https://ityman.ru/api/notification?key='.$key.'&phone='.$phone.'&id='.$id);
$result = json_decode($r, true);
if($result['status'] != 1){
print 'Ошибка: '.$result['error'];
}
$phone = '79000000001';
$id = 'S1-12';
$r = file_get_contents('https://ityman.ru/api/notification?key='.$key.'&phone='.$phone.'&id='.$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”:”Уведомление с таким ID не найдено”}
{“status”:0, “code”:6, “error”:”Указанный номер телефона не может получать сообщения от этого бота”}
{“status”:0, “code”:7, “error”:”Указанный номер телефона отписался от рассылки”}
{“status”:0, “code”:8, “error”:”Бот не найден или удален”}
{“status”:0, “code”:9, “error”:”Сообщение не было отправлено. Ошибка Telegram API.”}
{“status”:0, “code”:10, “error”:”Сообщение WhatsApp не отправлено. Пользователь не зарегистрирован, или номер сформирован неправильно. Поддерживаются только номера в международном формате. Пример для России: 79999999999.”}
{“status”:0, “code”:11, “error”:”Сообщение не было доставлено. Ошибка WhatsApp API.”}
{“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”:”Уведомление с таким ID не найдено”}
{“status”:0, “code”:6, “error”:”Указанный номер телефона не может получать сообщения от этого бота”}
{“status”:0, “code”:7, “error”:”Указанный номер телефона отписался от рассылки”}
{“status”:0, “code”:8, “error”:”Бот не найден или удален”}
{“status”:0, “code”:9, “error”:”Сообщение не было отправлено. Ошибка Telegram API.”}
{“status”:0, “code”:10, “error”:”Сообщение WhatsApp не отправлено. Пользователь не зарегистрирован, или номер сформирован неправильно. Поддерживаются только номера в международном формате. Пример для России: 79999999999.”}
{“status”:0, “code”:11, “error”:”Сообщение не было доставлено. Ошибка WhatsApp API.”}
{“status”:0, “code”:50, “error”:”Неверно указано поле BOT ID”}