У лимитов запросов репутация чего-то запутанного, полного исключений и мелкого шрифта, который становится понятен только после того, как что-то сломается. Наши лимиты проще, и их стоит ясно изложить в одном месте.
Каждый адрес получает 2 500 бесплатных запросов в день вообще без ключа. Эта квота выделяется не каждому адресу по отдельности, а делится на всю сеть: все адреса IPv4 в одной /24 и все адреса IPv6 в одной /48 расходуют один общий пул. Это важно, если вы находитесь за общим офисным подключением или крупной системой трансляции сетевых адресов (NAT), поскольку ваша бесплатная квота делится со всеми остальными в том же сегменте сети, независимо от того, используют ли они ключ.
Каждый ключ также получает собственную бесплатную дневную квоту в 2 500 запросов, отдельно от того, что уже предоставляет сеть. Квота ключа не уменьшается из-за другого трафика в той же сети, а квота сети не уменьшается из-за трафика, который уже израсходовал отдельную квоту ключа. Эти две квоты существуют бок о бок, а не конкурируют друг с другом.
Когда в конкретный день исчерпаны обе квоты, запрос либо списывается с предоплаченного баланса по 0,0001 € за запрос, либо покрывается пакетом Unlimited за 50 € в месяц, в зависимости от того, что настроено в аккаунте. Нет ограничения скорости, которое незаметно замедляет запросы, и нет неожиданной блокировки без объяснений. Каждый ответ содержит заголовки квоты X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit и X-Quota-Reset, так что точное положение запроса видно задолго до того, как он завершится ошибкой.
Пакетный вызов подчиняется тем же правилам на уровне элементов, а не вызова. Сто адресов, отправленных одним вызовом, учитываются как сто запросов в рамках действующей квоты, точно так же, как если бы они были отправлены сотней отдельных вызовов.
Всё это одинаково действует для каждого эндпоинта и каждого из семнадцати совместимых хостов. Запрос в формате OpenCage или ipstack ограничивается ровно теми же правилами, что и прямой запрос к /v1/forward или /v1/ip, без отдельного, более строгого лимита, скрытого за знакомым форматом ответа.
Полная информация, включая то, как работает ежедневный сброс и что означает каждый заголовок, приведена на /docs/rate-limits/. Если в вашей интеграции возникнет вопрос о лимите запросов, ответ почти всегда виден прямо в заголовках ответа, который его вызвал.