Личный кабинет

Главная → Документация → Несколько токенов

Несколько токенов: свой для каждой интеграции

Кроме основного токена, в личном кабинете можно выпустить дополнительные: отдельный токен для каждой программы, сервера или подрядчика. Баланс и цены у них общие, а отозвать можно каждый по отдельности, не останавливая остальные интеграции.

Баланс общийОтзыв сразуОграничение по методам и сроку

Зачем это нужно

Как выпустить

  1. Откройте раздел «Токены». Ссылка есть в карточке «API-токен» на главной странице личного кабинета.
  2. Задайте название, срок и методы. Название видно только вам. Срок: бессрочно, 30, 90, 180 дней или год. Методы: все или только отмеченные.
  3. Скопируйте токен. Целиком он показывается один раз, при создании: мы храним только его контрольную сумму. Потерянный токен восстановить нельзя, можно выпустить новый.

Как передавать

Так же, как основной токен. Дополнительный токен начинается с avc_:

curl "https://api.avtovincod.ru/pledge?vin=XTA210990Y1234567" \
  -H "Authorization: Bearer avc_3f9c0a...e41b" 

Что общего с аккаунтом, а что своё

Общее с аккаунтомСвоё у токена
Баланс и ценыда
Лимиты запросовда
Список разрешённых IPда
История запросов и статистикада, все токены вместечисло запросов и сумма за 30 дней
Название, срок действияда
Разрешённые методыда
Отзывда, остальные токены не затрагивает

Перевыпуск основного токена дополнительные не затрагивает.

Ограничение по методам

Токену можно разрешить только часть методов. Служебные методы отмечаются отдельно: balance (баланс), stats (статистика), report (сводный отчёт). Запрос к методу вне списка отвечает ошибкой TOKEN_SCOPE и ничего не списывает.

Для сводного отчёта токену нужен метод report. Какие блоки войдут в отчёт, определяется подключёнными аккаунту методами.

Коды ошибок

HTTPcodeЧто значит
401TOKEN_INVALIDТокена нет или он указан с ошибкой.
401TOKEN_REVOKEDТокен отозван.
401TOKEN_EXPIREDСрок действия токена истёк.
403TOKEN_SCOPEМетод не входит в список разрешённых этому токену.

Вопросы и ответы

Сколько токенов можно выпустить?

До 10 действующих одновременно. Отозванные и просроченные в счёт не идут.

Можно ли вернуть отозванный токен?

Нет. Выпустите новый.

Можно ли поменять срок или методы у действующего токена?

Да, в разделе «Токены»: кнопка «Изменить». Сам токен при этом не меняется.

Нужно ли что-то менять, если мне хватает одного токена?

Нет. Основной токен работает как раньше.