Ключи API

API (программный интерфейс) позволяет забирать данные datool.ru в свои программы: CRM, таблицы, дашборды, ИИ-ассистентов. Чтобы программа могла обращаться к API, ей нужен ключ — длинная секретная строка, которую она передаёт в каждом запросе. На вкладке «API-ключи» вы выпускаете и отзываете ключи, видите тариф API и расход запросов, а также вебхуки организации. Как писать сами запросы — в разделе API.

Где найти

hi.datool.ru/api-keys/ — вкладка «API-ключи» кабинета. Она видна всем участникам организации: каждый может выпустить свой ключ.

Ключи, лимит запросов и вебхуки принадлежат текущей организации — той, что выбрана в переключателе справа от заголовка кабинета.

Полоса-сводка: тариф и расход

• «Тариф API» и плашка уровня: «API.Max Тест» (бесплатно и без срока: карточки каналов и статистика за 30 дней), «API.Max Старт», «Рост», «Профи», «Корпоративный» или доступ, входящий в подписку «Бизнес». Под ним — до какого числа действует тариф и подключено ли автопродление.
• «Ключей» — сколько действующих ключей и сколько разрешает тариф.
• «Запросов в этом периоде» — сколько израсходовано из лимита, полоска и процент, дата «обновится ДАТА». Период — 30 дней с момента оплаты тарифа, а не календарный месяц; неистраченный остаток не переносится. У тарифа «по договору» — только число.
• «В секунду» — сколько запросов в секунду разрешает тариф.
• «В пакетах» — остаток купленных пакетов запросов и их срок (если есть).

Кнопки: «Тарифы API» (страница max.datool.ru/api/), «Купить запросы» — пакет +100 000 запросов за 990 ₽ на 30 дней («Подписки, пакеты и реквизиты») — и «Создать ключ», которая прокручивает к форме.

Обычный запрос расходует 1 единицу, поиск по публикациям — 5; запрос «кто я» (/v1/me/) и справочники — бесплатны. Подробно — «Лимиты».

Таблица ключей

Колонки:

• Ключ — название, маска (dtk_0bfc23a7_•••••••• — начало ключа, по которому его можно узнать) и отметка «чтение и запись», если она есть;
• Создал — почта участника, выпустившего ключ;
• Создан — дата;
• Последнее использование — когда ключ последний раз приходил в запросе («Ещё не использовался»);
• Запросов в этом периоде — расход этого ключа;
• Статус — «Действует» или «Отозван ДАТА»;
• «Отозвать» — свой ключ может отозвать любой участник, чужие — владелец и администратор.

Отзыв подтверждается в окне: ключ перестаёт работать сразу, вернуть его нельзя — понадобится новый. Отозванные ключи остаются в таблице бледными строками для истории.

Новый ключ

1. «Название ключа» (до 80 знаков) — чтобы отличать ключи друг от друга: «сервер аналитики», «отчёты отдела».
2. «Чтение и запись» — отметьте, если ключ будет управлять вебхуками (создавать и удалять их через API). Без отметки ключ только читает данные. Отметку потом изменить нельзя — понадобится новый ключ.
3. Нажмите «Создать ключ».

Над таблицей появится блок «Сохраните новый ключ» с полным ключом (он начинается с dtk_) и кнопкой «Скопировать». Полный ключ показывается один раз: после ухода со страницы его больше не увидеть, в таблице останется только маска. Скопируйте ключ и сохраните в надёжном месте — например, в менеджере паролей или в настройках программы.

Если ключей уже столько, сколько разрешает тариф (когда лимиты действуют), кнопка «Создать ключ» неактивна с подсказкой: «Лимит ключей исчерпан: отзовите ненужный или смените тариф».

Вебхуки

Вебхук — это адрес вашего сервера, на который datool.ru сам присылает новые посты выбранных каналов, — не нужно постоянно спрашивать API. Вебхуки доступны с тарифа «API.Max Рост» и создаются через API ключом с правом «Чтение и запись» («Вебхуки»). Здесь — их обзор:

• Адрес, Каналов (сколько каналов отслеживает), Последняя доставка (и текст ошибки, если была), Статус — «Включён» или «Выключен» с причиной;
• «Включить» — снова включить выключенный вебхук, «Удалить» — уведомления на этот адрес перестанут приходить сразу. Кнопки — у владельца и администратора.

Если вебхук сутки подряд не смог доставить ни одного события, он выключается сам, а владельцам и администраторам приходит письмо.

Как подключиться

Ключ передаётся в заголовке каждого запроса: Authorization: Bearer dtk_…. Первый запрос — GET https://api.datool.ru/v1/me/ («кто я и что мне открыто»): в ответе организация, тариф и остаток лимита. Ссылки блока: «Документация API», «Как считаются запросы» и «Подключить к ИИ-ассистенту (MCP)».

Правила ключей

• Ключи принадлежат организации, а не человеку: они расходуют общий лимит организации, и видят их все участники.
• Убрали участника из организации (или он вышел сам) — его ключи этой организации отзываются.
• Выключили участнику доступ, он встал на паузу из-за нехватки мест или организацию отправили в архив — его ключи приостанавливаются: API отвечает «доступ приостановлен», а когда доступ вернётся, ключи снова заработают.
• Лимит запросов — общий на организацию, его расходуют ключи всех участников. Сверх лимита API отвечает ошибкой 429 («лимит исчерпан»), сверх скорости — тоже 429 («слишком часто»).
• Владельцу приходят письма, когда израсходовано 80 % и 100 % лимита за период.

Смотрите также

• Быстрый старт API — первый запрос шаг за шагом.
• Ключи и авторизация — как передавать ключ и какие бывают ошибки.
• Лимиты — единицы, скорость, ответ 429.
• Вебхуки — новые посты на ваш сервер.
• MCP — подключение данных MAX к ИИ-ассистенту.