Начало
Ключи и доступ
Каждый запрос к API подписывается ключом аккаунта.
Как передать ключ
Authorization: Bearer hl_live_...Без ключа или с неверным ключом API ответит 401.
Виды ключей
| Начало ключа | Режим | Токены | Что делает |
|---|---|---|---|
hl_test_ | Тестовый | Не списываются | Отвечает как настоящий, в результате пример видео |
hl_live_ | Боевой | Списываются с баланса | Создаёт настоящие ролики |
Данные режимов разделены: тестовый ключ не видит боевые видео и файлы, и наоборот. Подробнее в разделе «Тестовый режим».
Уровни доступа
- Полный: любые запросы.
- Только чтение: только
GET. На создание, отмену и загрузку ответит403 insufficient_scope. Подойдёт для дашбордов.
Как хранить ключи
- Держите ключ в переменной окружения или хранилище секретов, не в коде и не в репозитории.
- Не вызывайте API из браузера или мобильного приложения: ключ оттуда легко достать. Запросы должны идти с вашего сервера.
- Заводите отдельный ключ на каждый сервис. Так видно, кто сколько тратит, и один ключ легко заменить.
Замена и отзыв
Мы храним только отпечаток ключа, поэтому показать его ещё раз нельзя. Потеряли — создайте новый и отзовите старый в списке ключей. Отзыв действует сразу. Чтобы заменить ключ без простоя, сначала выкатите новый, затем отзовите старый: одновременно может работать до 50 ключей.