Новости

Лимиты пакетных запросов: столько же, сколько уже разрешают крупные провайдеры

Пакетная интеграция, созданная для крупного устоявшегося провайдера, обычно строилась вокруг того размера пакета, который этот провайдер уже поддерживал, поскольку причин тестировать меньшие размеры почти не было. Когда ту же интеграцию переключают на нового провайдера, один из первых вопросов в том, будет ли принят уже отправляемый размер пакета или его сначала придётся разбивать на части поменьше.

Мы создавали обработку пакетов именно с учётом этой проблемы. Вместо того чтобы выбрать произвольный лимит и просить каждую интеграцию под него подстраиваться, мы рассчитали поддержку пакетов под то, что уже разрешают крупные провайдеры, которых заменяют наши совместимые хосты. Интеграции, отправляющей пакет в формате Geocodio или Google Maps Platform, не нужно менять размер пакета только потому, что изменился адрес назначения.

Цена пакетных запросов остаётся одинаковой независимо от размера: каждый элемент пакета считается одним запросом, а не весь вызов целиком. Пакет из ста адресов считается как сто запросов в рамках применимого лимита, будь то бесплатный дневной лимит, предоплаченный баланс по 0,0001 € за запрос или покрытие пакетом Unlimited. Нет никакого отдельного тарифа, который включается при определённом размере пакета, и нет смысла разбивать работу на меньшие вызовы только ради управления расходами.

Это одинаково применяется и к собственным эндпоинтам, и к совместимым хостам. Пакет, отправленный напрямую в /v1/forward, и пакет, отправленный на совместимый хост в формате крупного провайдера, обрабатываются одной и той же логикой пакетной обработки, с одинаковыми размерами, одинаковыми ценами и одинаковым отражением в заголовках квоты, прикреплённых к ответу.

Для команд, переносящих существующую пакетную интеграцию, это означает, что в части размера пакетов миграция должна пройти без происшествий. Руководства по миграции на /docs/compatibility/ описывают детали, которые стоит проверить для каждого провайдера, но лимиты размера пакетов не должны быть среди того, что требует дополнительной инженерной работы при переходе.

Если вы сейчас выполняете пакетные задания у провайдера, от которого думаете уйти, проверка того же размера пакета на соответствующем совместимом хосте My Geocode является быстрым способом убедиться в этом на практике. Это ничего не стоит, поскольку бесплатный лимит покрывает полноценное тестирование ещё до того, как потребуются какие-либо обязательства.