REST API тестовых данных
Один запрос — готовый набор записей для теста: вымышленные российские реквизиты, у которых сходятся контрольные суммы. Поля перечисляете вы, количество записей — до 100 за вызов, формат — JSON или CSV. Тот же seed даёт тот же результат, поэтому данные годятся для автотестов, а не только для демонстрационного стенда.
Быстрый старт
Подключение генератора тестовых данных за три шага
Возьмите список полей
GET /api/testdata/fields вернёт каталог: идентификатор,
название, группу, пример значения. Запрос бесплатный.
Запросите данные
GET /api/testdata?count=5&fields=fullName,innPerson,snils
— пять записей с тремя полями.
Зафиксируйте seed
Сохраните значение seed из ответа и передавайте его —
выдача повторится до последней цифры.
Эндпоинты
Базовый адрес: /api/testdata
Параметры в строке запроса
Самый быстрый способ получить данные из curl, браузера или Swagger.
count— сколько записей, от 1 до 100fields— идентификаторы через запятуюseed— начальное значение генератораgender—any,maleилиfemaleformat—jsonилиcsv
Те же параметры телом
Удобнее, когда полей много: список приходит массивом, а не строкой через запятую, и не упирается в предел длины адреса. Контракт и цена те же.
{
"count": 5,
"seed": 42,
"fields": ["fullName", "innPerson"],
"gender": "female",
"format": "json"
}Справочник полей · бесплатно
Каталог доступных типов данных: идентификатор, название, пояснение, группа, пример значения и признак контрольной суммы. Списания нет — это описание контракта, а не результат работы сервиса. Слот ограничения частоты запросов при этом расходуется наравне с остальными вызовами.
- Параметров нет
Возможности API
Что отличает генератор, пригодный для автотестов, от генератора случайных строк
Контрольные суммы
ИНН, СНИЛС, ОГРН, счёт, карта и VIN проходят проверку контрольного разряда.
Воспроизводимость
seed в запросе и в ответе: та же выдача в любой момент.
Согласованная запись
Счёт валиден со своим БИК, КПП — со своим ИНН, номер машины — с регионом.
CSV одним параметром
format=csv — плоская таблица со строкой заголовков.
Только нужные поля
30 типов данных: берите три или все сразу.
Согласование по полу
Имя, отчество и фамилия в одном роде, а логин и почта — производны от них.
Swagger
Спецификация OpenAPI и примеры запросов на двух языках.
Мгновенный ответ
Данные строятся на месте: ни одного обращения к внешним источникам — и ни одного ожидания.
Каталог полей
Идентификатор из первой колонки — это то, что передаётся в параметре
fields и становится ключом в записи ответа
| Идентификатор | Название | Группа | Сумма | Пример значения |
|---|---|---|---|---|
lastName |
Фамилия | Персона | — | Данилова |
firstName |
Имя | Персона | — | Вероника |
middleName |
Отчество | Персона | — | Михайловна |
fullName |
ФИО | Персона | — | Данилова Вероника Михайловна |
gender |
Пол | Персона | — | женский |
birthDate |
Дата рождения | Персона | — | 2004-01-31 |
innPerson |
ИНН физлица | Налоговые реквизиты | Есть | 582764367921 |
innCompany |
ИНН юрлица | Налоговые реквизиты | Есть | 5827680432 |
kpp |
КПП | Налоговые реквизиты | — | 582701824 |
snils |
СНИЛС | Документы | Есть | 593-562-578 41 |
ogrn |
ОГРН | Налоговые реквизиты | Есть | 1165895962143 |
ogrnip |
ОГРНИП | Налоговые реквизиты | Есть | 316588209357030 |
passport |
Паспорт РФ | Документы | — | 58 06 067997 |
bic |
БИК | Банк | — | 045004641 |
bankName |
Банк | Банк | — | АО «Альфа-Банк», Новосибирский филиал |
bankAccount |
Расчётный счёт | Банк | Есть | 40817810483551650737 |
correspondentAccount |
Корсчёт | Банк | Есть | 30101810450040000641 |
phone |
Телефон | Контакты | — | +7 (919) 728-46-14 |
email |
Контакты | — | v.danilova@example.net | |
login |
Логин | Контакты | — | vdanilova419 |
address |
Адрес | Адрес | — | 440907, Пензенская область, г. Кузнецк, проезд Некрасова, д. 51, кв. 53 |
region |
Регион | Адрес | — | Пензенская область |
city |
Город | Адрес | — | Кузнецк |
postalCode |
Индекс | Адрес | — | 440907 |
cardNumber |
Номер карты | Банк | Есть | 2202 1805 1512 0279 |
cardBrand |
Платёжная система | Банк | — | МИР |
cardExpiry |
Срок действия карты | Банк | — | 12/28 |
companyName |
Название организации | Организация | — | АО «Ориентир» |
vehiclePlate |
Автомобильный номер | Транспорт | — | Р798ТК58 |
vin |
VIN | Транспорт | Есть | XZU9XR8W4AC7YC6RT |
Поля в ответе идут в порядке этой таблицы независимо от того, в каком порядке вы их перечислили. Так CSV из двух разных запросов с одним набором полей всегда имеет одинаковые колонки, и файлы можно складывать друг с другом, не сверяя заголовки. Дубликаты в списке молча схлопываются.
Регион записи определяет сразу несколько полей: первые цифры ИНН, серию паспорта, код на автомобильном номере и первые три цифры индекса. Расчётный счёт валиден только в паре со своим БИК. Перемешивать поля между записями нельзя — получится набор, который не пройдёт вашу же перекрёстную проверку.
Нужна помощь с интеграцией?
Используйте Swagger ниже и примеры параметров. Для теста подойдут Postman, Thunder Client или curl.
Swagger документация API
Откройте спецификацию OpenAPI, чтобы проверить запросы и ответы генератора.
Тарификация за запись
Единица работы — одна сгенерированная запись, а не один вызов
| Код | Списание | Когда возникает |
|---|---|---|
| 200 | По числу записей | Данные сгенерированы. Запрос на 50 записей списывает 50 единиц и расходует 50 единиц дневной квоты. |
| 200 | Бесплатно | Справочник полей: он описывает контракт, а не приносит данные. Слот ограничения частоты запросов при этом расходуется. |
| 400 | Бесплатно | Недопустимое количество записей, неизвестное имя поля или неизвестный формат. Запрос отклоняется до начала работы. |
| 401 | Бесплатно | API-ключ отсутствует, просрочен или недействителен. |
| 402 | Бесплатно | Кредитов на балансе не хватает на запрошенное количество записей. |
| 429 | Бесплатно | Превышено ограничение частоты запросов. Повторите позже. |
Так счёт и бесплатный дневной лимит отражают объём полученных данных, а не число обращений: стоимость не должна зависеть от того, как выгрузка разбита на запросы. Потолок в 100 записей на вызов стоит по той же причине: он не про производительность — сотня записей строится за доли миллисекунды, — а про то, чтобы опечатка в параметре не списала заметную сумму одним запросом.
Почему выбирают наш API
Преимущества REST API генератора тестовых данных
Данные проходят вашу валидацию
Двенадцать случайных цифр — это не ИНН: ваша проверка отвергнет их на входе, и тест не проверит ничего. Здесь контрольные разряды рассчитаны по тем же правилам, что у настоящих реквизитов.
Тесты остаются стабильными
Проверка на конкретный ИНН имеет смысл только тогда, когда ИНН не меняется от запуска к запуску. Передайте seed — и выдача совпадёт сегодня, завтра и на сборочном сервере коллеги.
Простая интеграция
Один эндпоинт в двух видах — GET и POST — и никакого SDK. Ответ либо JSON с метаданными, либо готовый CSV, который можно сразу подать утилите импорта.
Никаких чужих данных
Сервис ничего не ищет в реестрах — он строит номер по правилам. Совпадение с реальным реквизитом случайно, и напоминание об этом приходит в каждом ответе.
Готовы подключить генератор?
Встройте API в свои тесты и сборку или откройте веб-интерфейс, чтобы собрать набор полей руками.