Запрос
Для пользователей бесплатных подсказок DaData.ru:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "Виктор Иван" }' \ https://dadata.ru/api/v2/suggest/fio
Для пользователей платных подсказок DaData.ru:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "Виктор Иван" }' \ http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/fio
Для пользователей standalone-подсказок:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "query": "Виктор Иван" }' \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/fio
Невозможно предоставить {include} Включенная страница не может быть найдена.
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
query | да | Запрос, для которого нужно получить подсказки |
count | нет | Количество возвращаемых подсказок (по умолчанию — 5, максимум — 20). |
parts | нет | Подсказки по части ФИО |
gender | нет | Пол (UNKNOWN / MALE / FEMALE) |
Ответ
Возвращается список объектов ФИО:
Поле | Тип данных | Описание |
---|---|---|
value | string(1000) | ФИО одной строкой |
unrestricted_value | string(1000) | = value |
data.surname | string(100) | Фамилия |
data.name | string(100) | Имя |
data.patronymic | string(100) | Отчество |
data.gender | string(10) | Пол
|
data.qc | string(10) | Код качества
|
data.source | Не заполняется |
Примеры
Запрос:
{ "query": "Виктор Иван", "count": 7 }
Ответ:
{ "suggestions": [ { "value": "Иванов Виктор", "unrestricted_value": "Иванов Виктор", "data": { "surname": "Иванов", "name": "Виктор", "patronymic": null, "gender": "MALE", "qc": null } }, { "value": "Иванченко Виктор", "unrestricted_value": "Иванченко Виктор", "data": { "surname": "Иванченко", "name": "Виктор", "patronymic": null, "gender": "MALE", "qc": null } }, { "value": "Виктор Иванович", "unrestricted_value": "Виктор Иванович", "data": { "surname": null, "name": "Виктор", "patronymic": "Иванович", "gender": "MALE", "qc": null } } ] }
Запрос:
<req> <query>Виктор Иван</query> <count>7</count> </req>
Ответ:
<SuggestResponse> <suggestions> <value>Иванов Виктор</value> <unrestricted_value>Иванов Виктор</unrestricted_value> <data> <surname>Иванов</surname> <name>Виктор</name> <patronymic/> <gender>MALE</gender> <qc/> </data> </suggestions> <suggestions> <value>Иванченко Виктор</value> <unrestricted_value>Иванченко Виктор</unrestricted_value> <data> <surname>Иванченко</surname> <name>Виктор</name> <patronymic/> <gender>MALE</gender> <qc/> </data> </suggestions> <suggestions> <value>Виктор Иванович</value> <unrestricted_value>Виктор Иванович</unrestricted_value> <data> <surname/> <name>Виктор</name> <patronymic>Иванович</patronymic> <gender>MALE</gender> <qc/> </data> </suggestions> </SuggestResponse>
Обзор
Инструменты контента