Главная → Документация → Несколько токенов
Несколько токенов: свой для каждой интеграции
Кроме основного токена, в личном кабинете можно выпустить дополнительные: отдельный токен для каждой программы, сервера или подрядчика. Баланс и цены у них общие, а отозвать можно каждый по отдельности, не останавливая остальные интеграции.
Зачем это нужно
- Утечка не останавливает работу. Токен попал в чужие руки: отзываете только его, остальные программы работают.
- Подрядчику не нужен основной токен. Выдайте токен со сроком действия и только с нужными методами.
- Видно, кто сколько тратит. По каждому токену в кабинете показаны последнее использование, число запросов и сумма списаний за 30 дней.
- Замена без простоя. Выпустили новый токен, переключили программу, отозвали старый.
Как выпустить
- Откройте раздел «Токены». Ссылка есть в карточке «API-токен» на главной странице личного кабинета.
- Задайте название, срок и методы. Название видно только вам. Срок: бессрочно, 30, 90, 180 дней или год. Методы: все или только отмеченные.
- Скопируйте токен. Целиком он показывается один раз, при создании: мы храним только его контрольную сумму. Потерянный токен восстановить нельзя, можно выпустить новый.
Как передавать
Так же, как основной токен. Дополнительный токен начинается с avc_:
curl "https://api.avtovincod.ru/pledge?vin=XTA210990Y1234567" \ -H "Authorization: Bearer avc_3f9c0a...e41b"
Что общего с аккаунтом, а что своё
| Общее с аккаунтом | Своё у токена | |
|---|---|---|
| Баланс и цены | да | |
| Лимиты запросов | да | |
| Список разрешённых IP | да | |
| История запросов и статистика | да, все токены вместе | число запросов и сумма за 30 дней |
| Название, срок действия | да | |
| Разрешённые методы | да | |
| Отзыв | да, остальные токены не затрагивает |
Перевыпуск основного токена дополнительные не затрагивает.
Ограничение по методам
Токену можно разрешить только часть методов. Служебные методы отмечаются отдельно: balance (баланс), stats (статистика), report (сводный отчёт). Запрос к методу вне списка отвечает ошибкой TOKEN_SCOPE и ничего не списывает.
Для сводного отчёта токену нужен метод report. Какие блоки войдут в отчёт, определяется подключёнными аккаунту методами.
Коды ошибок
| HTTP | code | Что значит |
|---|---|---|
| 401 | TOKEN_INVALID | Токена нет или он указан с ошибкой. |
| 401 | TOKEN_REVOKED | Токен отозван. |
| 401 | TOKEN_EXPIRED | Срок действия токена истёк. |
| 403 | TOKEN_SCOPE | Метод не входит в список разрешённых этому токену. |
Вопросы и ответы
Сколько токенов можно выпустить?
До 10 действующих одновременно. Отозванные и просроченные в счёт не идут.
Можно ли вернуть отозванный токен?
Нет. Выпустите новый.
Можно ли поменять срок или методы у действующего токена?
Да, в разделе «Токены»: кнопка «Изменить». Сам токен при этом не меняется.
Нужно ли что-то менять, если мне хватает одного токена?
Нет. Основной токен работает как раньше.