Аутентификация
Bearer-токен, получение и хранение ключей.
Ключ передаётся в заголовке Authorization каждого запроса:
curl https://app.mtwspy.com/public/v1/usage \
-H "Authorization: Bearer mtw_live_ваш_ключ"Ключ выглядит как mtw_live_ и 48 hex-символов. Если клиент не умеет задавать
Authorization, подойдёт заголовок X-Api-Key. В query-строке ключ не принимается.
Храните ключ как пароль
С ключом можно тратить просмотры вашего аккаунта. Не кладите его в репозиторий и в код, который выполняется в браузере.
Получение ключа
Ключи создаются в кабинете, в разделе API:
- Нажмите Создать ключ и задайте название.
- Скопируйте токен. Он показывается один раз, восстановить его нельзя.
API есть на тарифах Basic, Team и Team API. Создавать и отзывать ключи могут владелец команды и роль «Разработчик». Активных ключей на аккаунте — не больше 5. Отозванный ключ перестаёт работать сразу, потраченные просмотры при этом не возвращаются.
Ошибки авторизации
code | HTTP | Когда |
|---|---|---|
missing_token | 401 | Нет токена |
invalid_token | 401 | Токен неизвестен или неверного формата |
key_revoked | 403 | Ключ отозван |
plan_no_api | 403 | На тарифе нет доступа к API |
subscription_expired | 403 | Подписка истекла |