If you're interested in the English version of this spec, let us know on the GitHub.

fio

---

Подсказки по ФИО

POST

/suggest/fio

• Подсказывает ФИО одной строкой или отдельно фамилию, имя, отчество.
• Исправляет клавиатурную раскладку («fynjy» → «Антон»).
• Определяет пол.

Authorizations

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Type

API Key (header: Authorization)

Request Body

application/json

object

See https://dadata.ru/api/suggest/name/
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669111

Текст запроса.
@maxLength 300

Max Length300

Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10

Minimum1

Maximum20

Default10

Пол (UNKNOWN / MALE / FEMALE)

Valid values"MALE""FEMALE""UNKNOWN"

string[]

Подсказки по части ФИО:

• Только имена: ["NAME"]
• Имена и отчества: ["NAME", "PATRONYMIC"]
• Имена и фамилии: ["NAME", "SURNAME"]

Valid values"NAME""SURNAME""PATRONYMIC"

Responses

Запрос успешно обработан

Content-Type

application/json

object

Объект с массивом подсказок

object[]

Required

Массив подсказок или пустой массив

ФИО одной строкой

= value (ФИО одной строкой)

object

Required

Подробности о ФИО