API стандартизации

Endpoints для стандартизации ФИО и адресов.

Стандартизация ФИО

POST /api/v1/clean/name

Параметры запроса

Параметр	Тип	Описание
`query`	string	ФИО для стандартизации

Пример запроса

curl -X POST https://api.humandata.ru/api/v1/clean/name \
  -H "Content-Type: application/json" \
  -H "Authorization: Token YOUR_API_KEY" \
  -d '{"query": "иванов сергей петрович"}'

Пример ответа

{
  "source": "иванов сергей петрович",
  "result": {
    "surname": "Иванов",
    "name": "Сергей",
    "patronymic": "Петрович",
    "gender": "m",
    "qc": 0
  }
}

Поля ответа

Поле	Тип	Описание
`surname`	string	Фамилия
`name`	string	Имя
`patronymic`	string \| null	Отчество
`gender`	string	"m" (муж.) или "f" (жен.)
`qc`	number	Код качества (0 = OK)

Стандартизация адреса

POST /api/v1/clean/address

Пример запроса

curl -X POST https://api.humandata.ru/api/v1/clean/address \
  -H "Content-Type: application/json" \
  -H "Authorization: Token YOUR_API_KEY" \
  -d '{"query": "москва ленинский 42"}'

Пример ответа

{
  "source": "москва ленинский 42",
  "result": {
    "region": "Москва",
    "city": "Москва",
    "street": "Ленинский проспект",
    "house": "42",
    "postal_code": "119334",
    "fias_id": "...",
    "qc": 0
  }
}