logoric
Попробовать
LOGORIC / KNOWLEDGE

Инструкции и шаблоны

Настройка каждого раздела, проверка результата и готовые сценарии для вашего проекта.

Настройка · Руководство на русском

REST API, API-ключи и аудит

Control API имеет префикс /api/v1/organizations/{organization_id}. Полная схема реализованных DTO — docs/API.md.

Порядок настройки

  1. Создайте API key в настройках с минимальным scope и сроком действия. Скопируйте один раз. Он не является source token.
  2. Для чтения списка сервисов вызовите GET с Authorization: Bearer API_KEY. Для браузерной работы используется HttpOnly session cookie.
  3. Создание ресурсов требует write scope и соответствующей роли пользователя. JSON поля проверяются строго; неизвестные поля отклоняются.
  4. Проверяйте HTTP status и problem code/request_id. Не логируйте Authorization или тела с credentials. В Audit найдите действия по времени/actor.
  5. Отзовите ключ после завершения автоматизации. Для ingest используйте отдельный source token и другой endpoint.

Ожидаемый результат

Скрипт имеет доступ только к своей организации и разрешённым действиям.

Если не получается

401 — токен истёк/неверен. 403 — роль/scope/план. 404 может означать другой tenant. CSRF Origin должен соответствовать публичному адресу для browser mutations.