Аутентификация

Аутентификация с помощью API-ключей Bearer (dcs_live_ и dcs_test_) — как их создавать, хранить, ротировать и отзывать — и где они работают.

Каждому вызову публичного API нужен API-ключ в заголовке Authorization:

Authorization: Bearer dcs_live_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2

Ключ — это dcs_live_ или dcs_test_, за которым следуют 32 буквы и цифры. Отсутствующий заголовок, схема, отличная от Bearer, некорректный, неизвестный или отозванный ключ — во всех этих случаях запрос завершается ошибкой:

401 Unauthorized
{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing, invalid or revoked API key.",
    "request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
  }
}

Создание ключа

  1. В приложении откройте API-ключи и нажмите Новый ключ.
  2. Дайте ему имя (например, сервиса, который будет его использовать) и выберите окружение: Рабочий (dcs_live_…) или Тестовый (dcs_test_…).
  3. Нажмите Создать ключ и скопируйте его. Полный ключ показывается только один раз.

Сохраните его в менеджере секретов или в переменной окружения, например DCISION_API_KEY. Dcision хранит только SHA-256-хеш ключа, поэтому потерянный ключ восстановить нельзя — создайте новый.

В списке ключей для каждого ключа показаны имя, маскированная форма (dcs_live_9fK2…0Ad2), окружение, дата создания и время последнего использования (обновляется не чаще раза в минуту). Участники, администраторы и владелец могут создавать, переименовывать и отзывать ключи; наблюдатели видят только список — см. Команда, роли и аккаунт. В рабочем пространстве может быть до 50 активных ключей.

Рабочие и тестовые ключи

Оба окружения ведут себя одинаково: они вызывают одни и те же опубликованные версии, делят лимит запросов рабочего пространства и тарифицируются одинаково. Разница организационная — используйте тестовые ключи для staging, CI и локальной разработки, чтобы отзывать их, не затрагивая продакшен, — плюс один флаг: доставки в назначения для вызовов, сделанных тестовым ключом, содержат livemode: false, чтобы получатели могли не пускать их в продакшен.

Область действия

  • Ключ принадлежит одному рабочему пространству и может вызывать любое решение этого рабочего пространства, а также читать его решения, аккаунт и выполнения через GET /v1/decisions, GET /v1/me и GET /v1/executions. Тот же ключ аутентифицирует MCP-сервер.
  • Ключ из другого рабочего пространства не может добраться до ваших решений: он получает 404 DECISION_NOT_FOUND, а его /v1/executions показывает только запуски его собственного рабочего пространства.
  • Ключи работают только с публичным API (/v1/…). Эндпоинты приложения отклоняют их с 403 FORBIDDEN — "API keys can only call the /v1 decision endpoints."

Проверка ключа

GET /v1/me отвечает 200 с рабочим пространством, именем, окружением и тарифом ключа или 401 INVALID_API_KEY. Это дешёвая проверка для CI и скриптов деплоя — она не запускает решение и не тарифицируется:

curl -sf https://api.dcision.io/v1/me -H "Authorization: Bearer $DCISION_API_KEY" > /dev/null \
  && echo "key OK" || echo "key rejected"

Ротация ключа

  1. Создайте новый ключ.
  2. Задеплойте приложение с новым ключом.
  3. Отзовите старый ключ, когда его Последнее использование перестанет меняться.

Отзыв ключа

Отозвать действует немедленно и не может быть отменено: каждый запрос с этим ключом завершается ошибкой 401 INVALID_API_KEY. Отозванные ключи остаются в списке, выделенные серым, для справки.

Безопасность ключей

  • Вызывайте API со своего сервера, никогда — из браузера, мобильного приложения или клиентского бандла.
  • Никогда не коммитьте ключи в репозиторий; загружайте их из окружения.
  • Используйте отдельный ключ для каждого сервиса, чтобы можно было отозвать один, не затрагивая остальные.

На этой странице