API ITYMAN позволяет интегрировать сервисы авторизации, уведомлений и автозвонков в ваш сайт или приложение. Все запросы выполняются методом GET. API ключ можно получить в разделе «Личные данные» личного кабинета.
Авторизация
Для работы модуля «Авторизация» сайт должен отправлять коды подтверждения на API для каждого телефона. После ввода телефона пользователем отправьте код — он будет доставлен в Telegram или WhatsApp. Код действителен 24 часа.
URL эндпоинта
GET https://ityman.ru/api/activation
Параметры
| key | phone | code | bot_id |
|---|---|---|---|
| API ключ | Телефон (79000000000) | Код 4 цифры | ID канала (число из кабинета) |
bot_id — числовой ID канала из личного кабинета.
ID канала (параметр bot_id) можно посмотреть в личном кабинете: раздел «Автоматизация» → блок «Каналы» → откройте нужный канал. На странице настроек ID указан под строкой «Статус».
Формат телефона: Россия 7…, Казахстан 7…, Украина 380…, Беларусь 375…, и др. (международный формат без +)
Пример запроса (PHP)
$key = 'YOUR_API_KEY';
$phone = '79000000001';
$code = '1234';
$bot_id = 42; // ID канала из личного кабинета
$url = 'https://ityman.ru/api/activation?key='.$key.'&phone='.$phone.'&code='.$code.'&bot_id='.$bot_id;
$r = file_get_contents($url);
$result = json_decode($r, true);
if ($result['status'] != 1) {
echo 'Ошибка: '.$result['error'];
}Пример запроса (JavaScript)
const key = 'YOUR_API_KEY';
const phone = '79000000001';
const code = '1234';
const botId = 42; // ID канала из личного кабинета
const url = `https://ityman.ru/api/activation?key=${key}&phone=${phone}&code=${code}&bot_id=${botId}`;
const res = await fetch(url);
const result = await res.json();
if (result.status !== 1) {
console.error('Ошибка:', result.error);
}Ответы
Успех: {"status": 1}
Дополнительно: {"status": 1, "code": 6, "info": "Код принят, но телеграм-пользователь с таким номером не найден"}
Коды ошибок
Уведомления
Создайте задачу в личном кабинете: раздел «Задачи» → тип «Уведомление пользователю», источник события «Запрос API». У каждой задачи есть ID для API (в карточке и в редактировании). Отправьте GET-запрос с телефоном и id задачи — пользователь получит сообщение из этой задачи.
URL эндпоинта
GET https://ityman.ru/api/notification
Параметры
| key | phone | id |
|---|---|---|
| API ключ | Телефон (79000000000) | ID задачи (число из кабинета, поле «ID для API») |
id — числовой ID задачи с источником «Запрос API». Любые другие параметры запроса — переменные для текста задачи.
Произвольные переменные
В тексте уведомления можно использовать свои переменные. Укажите имя в фигурных скобках — {city}, {orderId} — и передайте значение в том же запросе к API.
Пример: текст «Доставка в {city}», запрос ...&city=Казань → пользователь получит «Доставка в Казань».
Пример запроса (PHP)
$key = 'YOUR_API_KEY';
$phone = '79000000001';
$id = 12;
$city = rawurlencode('Казань');
$url = 'https://ityman.ru/api/notification?key='.$key.'&phone='.$phone.'&id='.$id.'&city='.$city;
$r = file_get_contents($url);
$result = json_decode($r, true);
if ($result['status'] != 1) {
echo 'Ошибка: '.$result['error'];
}Пример запроса (JavaScript)
const key = 'YOUR_API_KEY';
const phone = '79000000001';
const id = 12;
const params = new URLSearchParams({
key,
phone,
id: String(id),
city: 'Казань',
});
const url = `https://ityman.ru/api/notification?${params}`;
const res = await fetch(url);
const result = await res.json();
if (result.status !== 1) {
console.error('Ошибка:', result.error);
}Ответы
Успех: {"status": 1}
Коды ошибок
Авторизация по звонку (Call-password)
Отправьте GET-запрос с телефоном и ID канала (параметр bot_id). Пользователь получит звонок с неизвестного номера — робот продиктует 4 цифры (код подтверждения). В ответе API вернёт код для проверки на вашем сайте.
URL эндпоинта
GET https://ityman.ru/api/flashcall
Параметры
| key | phone | bot_id |
|---|---|---|
| API ключ | Телефон (79000000000) | ID канала (число из кабинета) |
bot_id — числовой ID канала из личного кабинета.
ID канала (параметр bot_id) можно посмотреть в личном кабинете: раздел «Автоматизация» → блок «Каналы» → откройте нужный канал. На странице настроек ID указан под строкой «Статус».
Пример запроса (PHP)
$key = 'YOUR_API_KEY';
$phone = '79000000001';
$bot_id = 42;
$url = 'https://ityman.ru/api/flashcall?key='.$key.'&phone='.$phone.'&bot_id='.$bot_id;
$r = file_get_contents($url);
$result = json_decode($r, true);
if ($result['status'] != 1) {
echo 'Ошибка: '.$result['error'];
} else {
$code = $result['code']; // код для проверки на сайте
}Пример запроса (JavaScript)
const key = 'YOUR_API_KEY';
const phone = '79000000001';
const botId = 42;
const url = `https://ityman.ru/api/flashcall?key=${key}&phone=${phone}&bot_id=${botId}`;
const res = await fetch(url);
const result = await res.json();
if (result.status !== 1) {
console.error('Ошибка:', result.error);
} else {
const code = result.code; // код для проверки на сайте
}Ответы
Успех: {"status": "1", "code": "9999"}
Поле code содержит код подтверждения для проверки на сайте
Коды ошибок
API ключ можно получить в Настройки → API