Аутентификация
Аутентификация с помощью API-ключей Bearer (dcs_live_ и dcs_test_) — как их создавать, хранить, ротировать и отзывать — и где они работают.
Каждому вызову публичного API нужен API-ключ в заголовке Authorization:
Authorization: Bearer dcs_live_9fK2mQ7xLp4Rt8Vw1Zc6Nb3Hy5Js0Ad2Ключ — это dcs_live_ или dcs_test_, за которым следуют 32 буквы и цифры. Отсутствующий заголовок, схема, отличная от Bearer, некорректный, неизвестный или отозванный ключ — во всех этих случаях запрос завершается ошибкой:
{
"error": {
"code": "INVALID_API_KEY",
"message": "Missing, invalid or revoked API key.",
"request_id": "req_Qm8vT2kLx9Pw4Rz7Nc1B"
}
}Создание ключа
- В приложении откройте API-ключи и нажмите Новый ключ.
- Дайте ему имя (например, сервиса, который будет его использовать) и выберите окружение: Рабочий (
dcs_live_…) или Тестовый (dcs_test_…). - Нажмите Создать ключ и скопируйте его. Полный ключ показывается только один раз.
Сохраните его в менеджере секретов или в переменной окружения, например 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"Ротация ключа
- Создайте новый ключ.
- Задеплойте приложение с новым ключом.
- Отзовите старый ключ, когда его Последнее использование перестанет меняться.
Отзыв ключа
Отозвать действует немедленно и не может быть отменено: каждый запрос с этим ключом завершается ошибкой 401 INVALID_API_KEY. Отозванные ключи остаются в списке, выделенные серым, для справки.
Безопасность ключей
- Вызывайте API со своего сервера, никогда — из браузера, мобильного приложения или клиентского бандла.
- Никогда не коммитьте ключи в репозиторий; загружайте их из окружения.
- Используйте отдельный ключ для каждого сервиса, чтобы можно было отозвать один, не затрагивая остальные.