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