Генератор тестовых данных

В документации описан программный интерфейс сервиса Hitori (далее – «API»). Через API внешние приложения получают случайные тестовые данные: ФИО, контакты, ИНН, СНИЛС, логины, пароли и др.

Для того чтобы успешно взаимодействовать с API сервиса, необходимо получить токен доступа. Токен ― это специальный код, разрешающий доступ к использованию API конкретному пользователю. Подробная информация об авторизации и получению токена приведена на странице Токены.

Полученный токен, необходимо указывать в свойстве 'token' при каждом запросе к API.

Для снижения нагрузки на API установлены следующие квоты: до 50 строк за один запрос, до 1000 запросов в сутки.

JSON (JavaScript Object Notation) – это текстовый формат представления данных в нотации объекта JavaScript. Несмотря на своё название, JSON можно использовать не только в JavaScript, но и в любом другом языке программирования.

JSON также обладает достаточно весомым преимуществом. В отличие от других форматов является более компактным, что очень важно при обмене данными. Также он более прост в использовании, легче читать и писать.

Во многих языках программирования существуют модули и библиотеки для работы с JSON. В документе содержатся примеры работы с JSON на языке JavaScript.

Запросы в формате JSON передаются методом HTTP POST на следующий адрес:

https://hit.ori.one/api

В случае предоставления входных данных, API учитывает только доступные ключи и их свойства. API игнорирует все остальные данные.

// Тело запроса
config = {
    'token': 'gd156j81D5ASs235fsdlk1',
    'gender': 'female',
    'count': 5,
    'param': ['FirstName', 'Email', 'DocINN']
}

Ключами и их свойствами можно ознакомиться в таблице Ключи и свойства

Подробное описание ключей и их значений. При несуществующем значении применяется значение по умолчанию

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

Пример демонстрирует сетевой запрос и получение информации от сервера при помощи вызова метода fetch().

fetch("https://hit.ori.one/api", {
    // Метод HTTP-запроса
    method: 'POST',
    // Тело запроса в формате JSON
    body: JSON.stringify(config),
    // Заголовок запроса
    headers: {'Content-Type': 'application/json'}
})

// Ответ в формате JSON
.then(response => response.json())
// Обрабатываем результат
.then(result => console.log(result))
// Ловим ошибки
.catch(error => console.error('error', error));

В случае успеха сервер возвращает код 200 OK с полями объекта в формате JSON в виде:

[{"FirstName":"Валерия","Email":"omskaeriya@bk.ru","DocINN":"785720928970"},{"FirstName":"Алуа","Email":"pyninua@mail.ru","DocINN":"317511875225"},{"FirstName":"Лика","Email":"uhovka@list.ru","DocINN":"327805850082"},{"FirstName":"Марианна","Email":"rentevaarianna@rambler.ru","DocINN":"339778599004"},{"FirstName":"Люся","Email":"aburinayusy@yahoo.com","DocINN":"115361247501"},{"Status-codes":[200]}]

Возвращаемые статусы ошибок и их значения.