Аутентификация
Каждый запрос содержит API-ключ в стандартном заголовке Authorization. Ключи принадлежат одной учётной записи и расходуют кредиты этой учётной записи.
Authorization: Bearer du_live_...Создать ключ
- Требуется платная учётная запись. Выпуск отклоняется с кодом
403, пока учётная запись не приобретёт кредиты. - Открыть Профиль → Ключи API и создайте именованный ключ.
- Полный ключ отображается один раз. Сохраните его в переменной окружения или в менеджере секретов.
- До 10 активных ключей на аккаунт. Отзыв действует немедленно для новых запросов; уже запущенные задачи продолжают выполняться.
Как проверяется ключ
- Токен на предъявителя должен начинаться с
du_live_. - Ключ проверяется при каждом запросе.
- Отсутствующий, некорректно сформированный, неизвестный, отозванный ключ или ключ удалённой учётной записи — все возвращают одинаковый ответ
401 unauthorized. - На странице профиля для каждого ключа отображается время последнего использования.
Отозвать
Используйте кнопку отзыва на странице профиля. Отзыв идемпотентен; повторный отзыв того же ключа безвреден. Ключ, принадлежащий другой учётной записи, отображается как не найденный.
Храните это на стороне сервера
API не отправляет заголовки CORS. Он предназначен для серверов, скриптов и локальных агентов, а не для браузерного кода. Ключ в составе веб- или мобильного приложения — это публичный ключ.