Suggest Fio
POST
/suggest/fio
If you're interested in the English version of this spec, let us know on the GitHub.
- Подсказывает ФИО одной строкой или отдельно фамилию, имя, отчество.
- Исправляет клавиатурную раскладку («fynjy» → «Антон»).
- Определяет пол.
Official documentation:
https://dadata.ru/api/suggest/name/https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669115Authorizations
ApiKey
API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ
Type
API Key (header: Authorization)
Request Body
application/json
See https://dadata.ru/api/suggest/name/
See https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669111
Collapse
query
string
Required
Текст запроса.
@maxLength 300
Max Length
300count
number
Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10
Minimum
1Maximum
20Default
10gender
string
Пол (UNKNOWN / MALE / FEMALE)
Valid values
"MALE""FEMALE""UNKNOWN"parts
string[]
Подсказки по части ФИО:
- Только имена:
["NAME"] - Имена и отчества:
["NAME", "PATRONYMIC"] - Имена и фамилии:
["NAME", "SURNAME"]
Collapse
[item]
string
Valid values
"NAME""SURNAME""PATRONYMIC"Responses
Запрос успешно обработан
application/json
object
Объект с массивом подсказок
Collapse
suggestions
object[]
Required
Массив подсказок или пустой массив
Collapse
value
string
Required
ФИО одной строкой
unrestricted_value
string
Required
= value (ФИО одной строкой)
data
object
Required
Подробности о ФИО
Expand