# Ключи API

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

## Где найти

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

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

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

![Полоса-сводка: тариф API, ключи, запросы в этом периоде и кнопки](https://media.datool.ru/docs/guide/ru/cabinet-api-strip.webp)

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

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

| Тариф | Запросов за период | В секунду | Ключей |
|---|---|---|---|
| API.Max Тест | 1 000 | 1 | 1 |
| API.Max Старт | 100 000 | 5 | 2 |
| API.Max Рост | 300 000 | 10 | 5 |
| API.Max Профи | 1,5 млн | 20 | 20 |
| «Бизнес» MAX без тарифа API | 10 000 | 5 | 2 |
| API.Max Корпоративный | по договору | по договору | по договору |

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

!!! note "Сейчас расход только считается"
    Продажа тарифов API откроется вместе с методами данных. До этого лимиты запросов, скорости и числа ключей не ограничивают — кабинет показывает их справочно (строка «лимит включится вместе с продажей тарифов API»), а расход просто считается.

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

![Таблица «Ключи организации»: название, маска, кто создал, использование, расход, статус](https://media.datool.ru/docs/guide/ru/cabinet-api-keys.webp)

Колонки:

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

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

## Новый ключ

![Форма «Новый ключ»: название и «Чтение и запись»](https://media.datool.ru/docs/guide/ru/cabinet-api-new.webp)

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

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

!!! warning "Ключ — это пароль"
    С ключом любой может обращаться к данным от имени вашей организации и расходовать её лимит. Не публикуйте ключ, не присылайте его в открытых чатах и не вставляйте в код, который видят другие. Если ключ утёк — сразу отзовите его и выпустите новый.

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

## Вебхуки

![Блок «Вебхуки»: адрес, каналов, последняя доставка, статус](https://media.datool.ru/docs/guide/ru/cabinet-api-webhooks.webp)

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

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

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

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

![Блок «Как подключиться»: первый запрос с ключом](https://media.datool.ru/docs/guide/ru/cabinet-api-connect.webp)

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

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

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

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

- [Быстрый старт API](/api/start/) — первый запрос шаг за шагом.
- [Ключи и авторизация](/api/keys/) — как передавать ключ и какие бывают ошибки.
- [Лимиты](/api/limits/) — единицы, скорость, ответ 429.
- [Вебхуки](/api/webhooks/) — новые посты на ваш сервер.
- [MCP](/api/mcp/) — подключение данных MAX к ИИ-ассистенту.