Разработчикам

API и безопасные ошибки

Основные endpoints внешнего приложения и поведение при отказах контекста.

Обновлено: 7 августа 2026

Публичный Web Chat API

httpKanyman docs

POST /api/public/web-chat/{public_key}/sessions
Idempotency-Key: <unique-session-creation-key>
Content-Type: application/json

{
  "locale": "ru",
  "context_token": "<optional-signed-jwt>"
}

httpKanyman docs

PUT /api/public/web-chat/{public_key}/sessions/{session_id}/context
Authorization: Bearer <session_token>
Content-Type: application/json

{ "context_token": "<signed-jwt>" }

Результат обработки контекста

jsonKanyman docs

{
  "context_status": "rejected",
  "context_id": null,
  "context_error_code": "context_expired"
}

Ошибка контекста не отменяет chat-сессию. Интерфейс должен продолжить обычный чат и показать нейтральное сообщение о временно недоступной технической информации.

API кабинета

textKanyman docs

GET  /api/projects/{project_id}/external-integrations
POST /api/projects/{project_id}/external-integrations
GET  /api/projects/{project_id}/external-integrations/{integration_id}
POST /api/projects/{project_id}/external-integrations/{integration_id}/test-token
GET  /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools/{tool_id}/test

Создание и тестирование конфигурации требуют роли owner или admin в выбранном проекте. Все операции проверяют workspace/project scope.

Логи и ошибки

Продолжить

Web Chat v3Установка виджета, Origin, сессия и обновление контекста.Подписанный контекстJWT-конверт, JSON Schema, подпись и защита от повторов.Безопасность и запускЧеклист ключей, токенов, сетевых ограничений и production UAT.