Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Включить страницу
SGTDOC:О «Подсказках»: ФИО
SGTDOC:О «Подсказках»: ФИО

Запрос

Запрос

Для пользователей подсказок 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

...

Без форматирования
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

...

(API)
_Заголовки (API)

...

Authorization

API-ключ в формате: Token ${API_KEY}

...

Параметры

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

Ответ

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

Включить страницу
Объект ФИО
Объект ФИО

Примеры

Запрос:

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

...

Блок кода
languagejavascript
{
    "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"
            },
            "value": "Виктор Иванович"
        }
}
    ]
}

Запрос:

Блок кода
languagehtml/xml
<req>
    <query>Виктор Иван</query>
    <count>7</count>
</req>

...

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