Доступ по API

Токены для программ и ИИ-агентов

API-токен даёт внешней программе доступ к вашему пространству вместо пароля. Так подключают ИИ-агента, который сам создаёт заметки и задачи, скрипт переноса данных или сервис автоматизации.

Откройте «Профиль» → вкладка «API-токены».
Нажмите «Создать токен», укажите название, что разрешено и срок действия.
Скопируйте токен сразу: второй раз он показан не будет. Если потеряли — выпустите новый, а старый отзовите.
Передайте токен программе. Большинство клиентов принимает его как заголовок Authorization.

Токен передаётся заголовком Authorization со словом Bearer. Адрес пространства указывать не нужно: он берётся из самого токена, поэтому агенту достаточно знать только его.

curl -H "Authorization: Bearer dbt_ваш_токен" \
  https://api.get4.ru/api/nodes

curl -X POST https://api.get4.ru/api/nodes \
  -H "Authorization: Bearer dbt_ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"type": "note", "title": "Заметка от агента"}'

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

Токен действует от вашего имени и в пределах ваших прав. Если вы администратор пространства, токен получает администраторский доступ — обращайтесь с ним как с паролем.

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

Полный перечень методов, полей и ответов — на странице документации API по адресу api.get4.ru/api-docs. Она же отдаёт машинное описание в формате OpenAPI, которое понимают большинство клиентов и генераторов кода.