Cabi.Chat API — Персональные токены доступа

Персональный токен доступа (PAT) — ключ, который действует от вашего имени. Скрипты, CI-задачи, бэкенд на вашем сайте, ваш собственный AI-агент: всё, что обращается к Cabi.Chat API от вашего имени, предъявляет его как Authorization: Bearer <token>.

Что может токен

Токен видит ровно то, что можете видеть вы, и меняет ровно то, что можете менять вы, — не больше. Все правила карточек действуют для него так же, как в приложении: карточки сохраняют свою видимость, а созданная им карточка начинается приватной, как и созданная вами. Тот, у кого токен, действует как вы, поэтому храните его как пароль: не в тексте карточек, не в чатах, постах и общих файлах.

Выпуск

• В приложении: Профиль → Персональные токены доступа → дайте имя (ci, laptop, script) → Выпустить токен.
• Через API, из сессии входа (токен не может выпускать токены): POST /v0/my/pats с {"name": "ci"} и заголовком Idempotency-Key.

Токен показывается один раз. Ответ может также предложить одноразовое скачивание небольшого файла с ключом; откройте его сами и никому не передавайте эту ссылку. Cabi.Chat хранит только отпечаток токена, поэтому потерянный токен показать снова нельзя: выпустите новый и отзовите старый. Повтор выпуска: Cabi.Chat API — Создание карточек: идемпотентность и лимиты

Токены начинаются с cabi_pat_, поэтому сканеры секретов легко их замечают.

Управление

• GET /v0/my/pats: имя, короткое превью токена, время последнего использования, отозван или нет. Сам токен — никогда.
• POST /v0/my/pats/{nonce}/revoke: токен перестаёт работать со следующего запроса. В списке он остаётся как отозванный.
• DELETE /v0/my/pats/{nonce}: отозвать и убрать из списка.

Границы

• Один токен на агента. Давайте токен только агенту или скрипту, которому доверяете, каждому свой, чтобы отозвать один, не трогая остальные. Отзывайте те, которыми больше не пользуетесь.
• Если токен мог утечь. Отзовите его и проверьте список на токены, которые вы не узнаёте.
• Настройка оракулом Cabi.Chat. С вашего согласия оракул Cabi.Chat может настроить вашу страницу за вас. Вы получите уведомление в чате, а его доступ появится в вашем списке под именем ассистента. Отозвать доступ можно в любой момент: Профиль → Персональные токены доступа, или попросите об этом ассистента. Как забрать страницу себе: Telegram вместо паролей: входите с аккаунтом, которым уже пользуетесь
• Оракулы, которых вы хостите сами, не используют ваш токен: Cabi.Chat API — приложения