К генератору
РУКОВОДСТВА ПО АДРЕСАМ

Документация API

До 100 записей JSON с тем же детерминированным генератором.

GET /api/addresses

country — двухбуквенный код страны (uk для Великобритании), region — необязательное английское название региона. seed обязателен. count по умолчанию 1, максимум 100. Неизвестные параметры отклоняются.

GET /api/addresses?country=us&count=2&seed=demo

Повторяемый результат

Одинаковые параметры дают одинаковые записи. Не отправляйте личные данные. Аккаунты, ключи API и оплата не подключены. Перед публичным запуском настройте ограничения частоты запросов на шлюзе.

Ошибки

Неверная страна, регион, количество или отсутствие seed возвращают HTTP 400. Успешный ответ содержит массив data, count и synthetic.

Ограничения и ошибки адресного API

Открытый API требует начальное значение и принимает 1–100 строк за запрос. Страна и фильтры должны совпадать; неверные параметры возвращают HTTP 400. Браузер поддерживает до 1 000 строк. Правильный формат не подтверждает доставку.