ИнференсПомощь
Лимиты и расход
Как считается расход кредитов по трём окнам, где посмотреть остаток и что делать, когда лимит исчерпан.
Расход считается в кредитах и списывается с аккаунта владельца ключа. У каждого тарифа есть лимиты на три окна: сессию, неделю и месяц. Остаток по каждому окну приходит в заголовках ответа, а когда лимит исчерпан, API отвечает кодом 429 и сообщает, когда запас обновится.
Три окна
| Окно | Когда начинается |
|---|---|
| Сессия длиной 5 часов | С первого платного запроса. |
| Неделя | В тот же день недели и час, когда вы зарегистрировались. |
| Месяц | С числа регистрации, а на платном тарифе — с момента перехода на него. |
Лимиты каждого тарифа указаны на странице Тарифы, текущий расход — в кабинете console.yenisei.ru.
Заголовки ответа
| Заголовок | Что в нём |
|---|---|
X-RateLimit-Remaining-Session | Остаток кредитов в окне сессии. |
X-RateLimit-Remaining-Week | Остаток кредитов в окне недели. |
X-RateLimit-Remaining-Month | Остаток кредитов в окне месяца. |
Retry-After | Через сколько секунд обновится исчерпанный лимит. Приходит в ответе 429. |
X-RateLimit-Reset | Момент обновления лимита в формате unix-времени. Приходит в ответе 429. |
Остаток указан в нанокредитах: 1 кредит равен 1 000 000 000 нанокредитов.
Что делать, когда лимит исчерпан
API отвечает кодом 429 и кодом окна: session_limit_exceeded,
week_limit_exceeded или month_limit_exceeded. Правильное поведение
программы — подождать столько секунд, сколько указано в Retry-After, и
повторить запрос, а не отправлять его снова и снова.