# Добавление канала

Описание

Метод позволяет добавить канал в базу TGStat.

Метод доступен в "API Stat" и "API Search" (на тарифах S и выше)

POST-запрос должен быть отправлен в одном из форматов: Content-Type: multipart/form-data или Content-Type: application/json

# Запрос


# URL запроса

POST

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"
}