Ограничения
Предел частоты запросов, число ключей, размер запроса и правила кеширования ответов.
Частота запросов
Не больше 300 запросов за 60 секунд с одного адреса отправителя.
- Счёт ведётся по IP-адресу, с которого пришёл запрос, а не по ключу. Несколько ваших серверов за одним адресом делят предел между собой.
- Ручки чтения считаются вместе: запрос к любой из них уменьшает общий остаток.
- В счёт идут и запросы, отклонённые из-за ключа.
Остаток виден в заголовках каждого ответа:
| Заголовок | Что в нём |
|---|---|
RateLimit-Limit | Предел |
RateLimit-Remaining | Сколько запросов осталось до конца окна |
RateLimit-Reset | Через сколько секунд счёт начнётся заново |
RateLimit-Policy | Предел и длина окна одной строкой |
Запрос сверх предела получает отказ 429. Подождите столько секунд, сколько названо в RateLimit-Reset: до конца окна ответ будет тем же.
Ключи
У мерчанта может быть не больше 10 ключей одновременно. Подробно: Авторизация.
Размер запроса
Тело запроса принимается только в JSON и не больше 256 КБ. У выпущенных сегодня ручек тела нет вовсе.
Кеширование
Ответы API нельзя кешировать: у каждого стоит заголовок Cache-Control: no-store. Это относится и к промежуточным узлам на вашей стороне: устаревшая копия списка сервисов показала бы плательщику способ оплаты, которого уже нет.