Ваши API-ключи

Как создать ключ

1. Откройте аватар › API-ключи и выберите Новый API-ключ.
2. Назовите его по тому, что будет его использовать, например по инструменту отчётов.
3. Выберите Только чтение или Чтение и изменение.
4. Скопируйте его сейчас: ключ показывается только один раз.

Что может ключ

Ключ может то же, что и вы в этом рабочем пространстве, и не больше: ключ владельца видит всё, ключ менеджера партнёров видит своих партнёров, ключ партнёра видит только его собственные данные. Он никогда не делает то, что может только вошедший человек: управление ключами, паролями или командой.

Каждое изменение, сделанное ключом, подписано его именем в журнале действий, например «API-ключ «BI» (создал Maria)», чтобы вы всегда знали, что пришло через API.

Как использовать

Передавайте его с каждым запросом на адрес вашего рабочего пространства, в x-api-key или как Authorization: Bearer. Все запросы перечислены в Справочник API.

Полезно знать

• Тариф HitCTRL вашего пространства решает, работают ли ключи и сколько запросов в минуту им можно. При превышении лимита ответ — 429 с Retry-After.
• Отзовите ключ, который больше не нужен: он сразу перестанет работать и останется в списке, чтобы его изменения сохранили имя.
• Запросы трекинга с вашего сервера используют собственные ключи пространства: см. API-ключи.