Удостоверяване
- Authorization: ApiKey
- API ключът се изпраща единствено в заглавката Authorization на POST /api/v1/auth/token. Не го поставяйте в JSON, URL или параметрите на заявката.
- Authorization: Bearer
- Използвайте получения токен за заявки към ресурси и го подновявайте според expires_at; expires_in е в секунди.
Защо първо се получава токен?
API ключът служи за получаване на токен. Токенът е валиден 15 минути и може да се използва за няколко заявки. Към ресурсите изпращайте само токена в заглавката Authorization: Bearer.
Обикновените заявки не съдържат API ключа. Изтекъл към трета страна токен дава достъп най-много до края на валидността си. Откраднат API ключ все пак може да позволява получаване на нови токени.
Колко време е валиден токенът?
- expires_in
- 900 секунди, тоест 15 минути от издаването. Изпращането на заявки не удължава валидността.
- expires_at
- Момент на изтичане в UTC. Текущите ограничения за достъп могат да блокират токена по-рано.
Кога да получите следващ токен?
Използвайте един токен за няколко заявки и получете следващия преди expires_at. Не получавайте нов токен преди всяка операция. За новия токен използвайте API ключа.
Отказан достъп и повторни опити
- 401
- 401 не винаги означава изтекла валидност на токена. Ако е изтекла, получете нов токен и повторете четенето най-много веднъж. Ако получаването на токен връща 401, проверете ключа и спрете автоматичните опити.
- 403
- При 403 проверете правата, IP ограниченията и плана. Нов токен не възстановява отнет достъп.
IP ограничения
- Токенът за достъп не заобикаля текущите права на ключа, правата на магазина, отмяната на достъп или IP ограниченията.
- Когато е подходящо, ограничете ключа до изходните адреси на интеграцията.
- Администраторът може да редактира списъка; приемат се най-много 32 адреса.
Управление на ключове
- Управлението на API ключове е отделно от правата на интеграцията за ресурси.
- Само owner може да предоставя на групи административни права за преглед, създаване, редактиране или изтриване на ключове; упълномощеният член може да извършва само действията, разрешени на групата.
Ограничения на честотата
Engine ≥ 4.143.0. Всеки отговор с токен съдържа data.rate_limits от политиката на магазина при издаването. Всички ключове споделят тези лимити; нов токен не ги нулира. Промяна на плана може да важи преди изтичането на токена.
- read_per_minute
- Заявки за четене в минута.
- write_per_minute
- Заявки за запис в минута; тази стойност не дава права за запис.
- auth_per_minute
- Заявки за токен в минута, включително неуспешните опити за удостоверяване.