Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "Виктор Иван" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/fio

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки
count
нет
partsнетПодсказки по части ФИО
genderнетПол (UNKNOWN / MALE / FEMALE)

Ответ

Возвращается список объектов ФИО:

Примеры

Запрос:

{
  "query": "Виктор Иван",
  "count": 7
} 

Ответ:

{
    "suggestions": [
        {
            "value": "Иванов Виктор",
            "unrestricted_value": "Иванов Виктор",
            "data": {
                "surname": "Иванов",
                "name": "Виктор",
                "patronymic": null,
                "gender": "MALE"
            }
        },
        {
            "value": "Иванченко Виктор",
            "unrestricted_value": "Иванченко Виктор",
            "data": {
                "surname": "Иванченко",
                "name": "Виктор",
                "patronymic": null,
                "gender": "MALE"
            }
        },
        {
            "value": "Виктор Иванович",
            "unrestricted_value": "Виктор Иванович",
            "data": {
                "surname": null,
                "name": "Виктор",
                "patronymic": "Иванович",
                "gender": "MALE"
            }
        }
    ]
}

Запрос:

<req>
    <query>Виктор Иван</query>
    <count>7</count>
</req>

Ответ:

<SuggestResponse>
    <suggestions>
        <value>Иванов Виктор</value>
        <unrestricted_value>Иванов Виктор</unrestricted_value>
        <data>
            <surname>Иванов</surname>
            <name>Виктор</name>
            <patronymic/>
            <gender>MALE</gender>
        </data>
    </suggestions>
    <suggestions>
        <value>Иванченко Виктор</value>
        <unrestricted_value>Иванченко Виктор</unrestricted_value>
        <data>
            <surname>Иванченко</surname>
            <name>Виктор</name>
            <patronymic/>
            <gender>MALE</gender>
        </data>
    </suggestions>
    <suggestions>
        <value>Виктор Иванович</value>
        <unrestricted_value>Виктор Иванович</unrestricted_value>
        <data>
            <surname/>
            <name>Виктор</name>
            <patronymic>Иванович</patronymic>
            <gender>MALE</gender>
        </data>
    </suggestions>
</SuggestResponse>