# Добавление канала
Описание
Метод позволяет добавить канал в базу TGStat.
Метод доступен в "API Stat" и "API Search" (на тарифах S и выше)
POST-запрос должен быть отправлен в одном из форматов:
Content-Type: multipart/form-data
или Content-Type: application/json
# Запрос
# URL запроса
https://api.tgstat.ru/channels/add
# Параметры
Параметр | Описание | Значение по умолчанию | Обязательно |
---|---|---|---|
token | Ваш токен | Не задан | Да |
channelName | Username канала | Не задан | Да |
country | География канала (страна) | ru | |
language | Язык контента канала | russian | |
category | Категория канала | Не задан |
Допустимый формат параметра channelName
@username, t.me/username, https://t.me/username, http://t.me/username
# Ответ
# Канал добавлен в очередь на добавление
{
"status": "pending"
}
Добавление канала происходит в асинхронном режиме, а ответ о том, что задание на добавление принято (статус pending) - вы получаете сразу.
При повторных запросах с теми же параметрами вы будете получать статус pending до тех пор, пока задание находится в очереди.
После того, как задание обработалось на стороне TGStat, статус сменится на ok или error. Задание на добавление канала может обрабатываться до 15 минут, но обычно не превышает 10-20 секунд.
# Канал успешно добавлен
{
"status": "ok",
"response": {
"channelId": 1
}
}
Полученный channelId можно использовать в методе channels/get для получения подробной информации о канале.
# Ошибки
# Переданный username канала невалиден и/или канала не существует в Telegram
{
"status": "error",
"error": "wrong_channel_name"
}
# Канал уже зарегистрирован в базе TGStat
{
"status": "error",
"error": "channel_already_exist"
}