Следите за использованием ключа, пока не упёрлись в лимит
Наблюдение за заголовками квоты по ходу работы показывает приближение к лимиту задолго до того, как запрос будет отклонён.
Тестирование интеграции без расхода дневной квоты
Создание интеграции обычно означает десятки или сотни тестовых вызовов, прежде чем что-либо приблизится к рабочему трафику, и ни одному из этих тестов не нужен платный уровень.
Тестирование вообще без ключа
2 500 бесплатных запросов в день доступны с любого адреса вообще без ключа, и этого хватает для большей части работы над интеграцией: настройки формата запросов, проверки разбора ответов и отработки обработки ошибок на нескольких тестовых случаях для каждого.
GET /v1/forward?q=Test Address, Test City&limit=1Никакого заголовка X-API-Key, никакого заголовка Authorization, ничего, кроме самого запроса.
Следите за заголовками квоты во время тестирования
Даже без ключа каждый ответ содержит те же заголовки квоты, поэтому вы можете наблюдать, как X-Quota-Used растёт, а X-Quota-Free-Remaining уменьшается точно так же, как в продакшене; это полезно, чтобы проверить, как ваш собственный код обрабатывает эти заголовки, ещё до того, как это станет важно по-настоящему.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458Тестирование ключа без расхода баланса
После того как вы зарегистрируетесь и создадите ключ, этот ключ тоже получает собственные 2 500 бесплатных запросов в день: отдельное пространство для тестирования, которое не затрагивает предоплаченный баланс и не расходует пакет Unlimited. Именно на этом этапе стоит проверить поведение, связанное с ключом, например разные способы его передачи (заголовок, bearer-токен, basic auth или параметр запроса), и всё это ничего не тратя.
Намеренная проверка сценариев ошибок
Отправьте запрос с недопустимым параметром, чтобы увидеть 400, или с заведомо неверным ключом, чтобы увидеть 401: так код обработки ошибок будет действительно проверен до запуска, а не просто считаться рабочим. Каждый такой тестовый вызов, успешный или нет, расходует один запрос из бесплатной квоты, и при обычных объёмах тестирования это не должно вас беспокоить.
Переход к рабочему трафику
Когда начинается реальный трафик, та же бесплатная квота продолжает покрывать обычное суточное использование для многих небольших интеграций, а предоплаченный баланс или пакет Unlimited нужны только тогда, когда объём превышает 2 500 запросов в день.
Отдельная тестовая среда (sandbox) здесь не нужна, поскольку бесплатная квота уже даёт полноценную площадку для тестирования с настоящим API. Начните с создания ключа в личном кабинете или сначала прочитайте документацию по аутентификации, если хотите увидеть форматы ключей до регистрации.