https://bot-api.targethunter.ru/external-api/v2/lists/create
Создаёт в сообществе новый обычный список подписчиков — как кнопка «Создать список» в интерфейсе.
Нужен личный токен с продуктом BotHunter — как получить. Кому доступен: владельцу сообщества и сотрудникам с ролью «Админ (полный доступ)» или «Пользователи».
Лимит: не больше 20 созданий в минуту и 200 в сутки — вместе с
vars/createиglobalVars/create. Считается и попытка с ошибкой в параметрах, сутки начинаются в 03:00 по Москве. Сверх лимита — ошибка5, ничего не создаётся.
| Номер сообщества — Пример: |
| Канал сообщества: Пример: |
| Название списка, до 120 символов. Названия могут повторяться, как и в интерфейсе. Пример: |
Возвращает созданный список — как элемент lists/get. Его id передавайте как list_id в остальные методы lists/*.
{
"status": "ok",
"response": {
"id": "65a6e5f4c0e8f20012d3a111",
"name": "Клиенты",
"count_users": 0
}
}Общие ошибки — на странице API.
Код | Когда |
|---|---|
| «Слишком много созданий: не больше 20 в минуту и 200 в сутки. Повторите позже.»: лимит созданий исчерпан, ничего не создано. |
| Не передан «Не указан обязательный параметр name»: «Поле "Название" должно принимать значение менее чем 120 символов.»: название длиннее 120 символов. |
Подставьте свой токен вместо <ваш_токен>.
curl -X POST https://bot-api.targethunter.ru/external-api/v2/lists/create \
-H "Authorization: Bearer <ваш_токен>" \
-H "Content-Type: application/json" \
-d '{"group_id": 123456, "channel": "VK", "name": "Клиенты"}'$token = '<ваш_токен>';
$url = 'https://bot-api.targethunter.ru/external-api/v2/lists/create';
$params = [
'group_id' => 123456,
'channel' => 'VK',
'name' => 'Клиенты',
];
$curl = curl_init($url);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($params),
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);import requests
token = '<ваш_токен>'
url = 'https://bot-api.targethunter.ru/external-api/v2/lists/create'
params = {
'group_id': 123456,
'channel': 'VK',
'name': 'Клиенты',
}
response = requests.post(url, json=params, headers={'Authorization': f'Bearer {token}'})
print(response.json())const token = '<ваш_токен>';
const params = {
"group_id": 123456,
"channel": "VK",
"name": "Клиенты"
};
const response = await fetch('https://bot-api.targethunter.ru/external-api/v2/lists/create', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json',
},
body: JSON.stringify(params),
});
console.log(await response.json());