Перейти к содержимому

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

Отправляйте секретный ключ как bearer-токен в каждом запросе:

Authorization: Bearer brd_sk_live_...

Каждый ключ имеет scope (область действия) по двум осям:

  • Доступ — чтение или чтение-запись.
  • Охват — весь воркспейс или один проект.

Запрос, выходящий за пределы scope ключа, отклоняется с 403 permission_error (insufficient_scope). Ключ с scope на проект всегда видит только свой проект.

HTTP type code Значение
401 authentication_error unauthorized, expired Ключ отсутствует, недействителен, отозван или истёк.
403 permission_error insufficient_scope У ключа нет необходимого доступа, либо ресурс вне его scope.

Полный каталог см. в разделе Ошибки.