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