API-ключ
API-ключ — секретный идентификатор аккаунта в API, передаваемый как bearer-токен в каждом запросе.
Подробно
Ключи здесь хранятся в виде хешей, имеют фиксированные scope, могут быть привязаны к диапазону IP и получить срок действия. Запрос отклоняется, если ключ отозван, истёк, не имеет нужного для эндпоинта scope или приходит с адреса вне списка — четыре разных сбоя с четырьмя разными ошибками, так что причину не приходится угадывать. Автоматическому агенту выдавайте отдельный узкий ключ, а не тот, что использует ваш кабинет.
Также известно как
- bearer token
- access key
- secret key
Связанные термины
- Лимит запросовЛимит запросов ограничивает число обращений к API с одного ключа в минуту; здесь это 120 при всплеске до 20 запросов в секунду.
- Scope, область доступаScope — именованное разрешение на API-ключе, ограничивающее набор доступных эндпоинтов: чтение баланса, покупка номеров, управление арендой.