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

Ключ

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

Запрос

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

Для пользователей standalone-подсказок:

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "волы" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/party

Заголовки

ЗаголовокОписание
Content-Type

Тип данных в запроосе: application/json или application/xml

Accept
Тип данных в ответе: application/json или application/xml
Authorization

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

Только для пользователей подсказок DaData.ru

Подсказки по компании (REST)

URL: {base_path}/suggest/party

...

Параметры

ПараметрОбязательный?Описание
queryдаСтрокаЗапрос, для которой которого нужно получить подсказки
count
нетКоличество возвращаемых подсказок (если не указано, используется значение по умолчанию).

...

Ответ

Возвращается список объектов организации:

Раскрыть
titleПоказать

Включить страницу
Объект организации
Объект организации

Примеры

JSON

Запрос:

Блок кода
languagejavascript
{
  "query": "ХФ Лабсволы" 
}

Ответ:

Раскрыть
titleПоказать
Блок кода
languagejavascript
{
    "suggestions": [
        {
            "value": "
ООО
ЗАО 
ХФ ЛАБС
Волы",
            "unrestricted_value": "
ООО
ЗАО 
ХФ ЛАБС
Волы",
            "data": {
                "kpp": 
null
"770901001",
                "management": {
                    "name":
null
 "Еремин Денис Андреевич",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "address": {
                    "value": "
127473 РОССИЯ
109004, 
МОСКВА
Москва 
Г
г, 
Г
Земляной Вал 
МОСКВА
ул, 
УЛ СЕЛЕЗНЕВСКАЯ
68/18, 
Д 11А СТР 2 ОФ 715
СТР.3",
                    "unrestricted_value": "
127473 РОССИЯ
109004, 
МОСКВА
Москва 
Г
г, Земляной 
Г
Вал 
МОСКВА
ул, 
УЛ СЕЛЕЗНЕВСКАЯ
68/18, 
Д 11А СТР 2 ОФ 715
СТР.3",
                    "data": null
                },
                "type": "LEGAL",
                "opf": {
                    "code": "
12165
12267",
                    "full": "
Общество
Закрытое 
с
акционерное 
ограниченной ответственностью
общество",
                    "short": "
ООО
ЗАО"
                },
                "name": {
                    "latin": null,
                    "full": "
ХФ ЛАБС
ВОЛЫ",
                    "short": 
null
"Волы"
                },
                "inn": "
7707545900
7709420914",
                "ogrn": "
1057746629115
1037709040753",
                "okpo": 
null
"14224803",
                "okved": 
null
"63.40",
                "state": {
                    "status": "ACTIVE",
                    "registration_date": 
1113163200000
1052164800000,
                    "liquidation_date": null
                }
            }
        }
    ]
}
XML

Запрос:

Блок кода
languagehtml/xml
<req>
  <query>хф лабс<<query>волы</query>
</req>

Ответ:

Раскрыть
titleПоказать
Блок кода
languagehtml/xml
<SuggestResponse>
    <suggestions>
        
<value>ООО
<value>ЗАО 
ХФ ЛАБС<
Волы</value>
        <unrestricted_
value>ООО
value>ЗАО 
ХФ ЛАБС<
Волы</unrestricted_value>
        <data>
            
<kpp/>
<kpp>770901001</kpp>
            <management>
                <name>Еремин Денис Андреевич</name>
                <post>Генеральный директор</post>
            
<management
</
>
management>
            <branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <address>
                
<value>127473 РОССИЯ
<value>109004, 
МОСКВА
Москва 
Г
г, 
Г
Земляной Вал 
МОСКВА
ул, 
УЛ СЕЛЕЗНЕВСКАЯ, Д 11А СТР 2 ОФ 715<
68/18, СТР.3</value>
                <unrestricted_
value>127473 РОССИЯ
value>109004, 
МОСКВА
Москва 
Г
г, 
Г
Земляной Вал 
МОСКВА
ул, 
УЛ СЕЛЕЗНЕВСКАЯ
68/18, 
Д 11А СТР 2 ОФ 715<
СТР.3</unrestricted_value>
                <data/>
            </address>
            <type>LEGAL</type>
            <opf>
                
<code>12165<
<code>12267</code>
                
<full>Общество
<full>Закрытое 
с
акционерное 
ограниченной ответственностью<
общество</full>
                
<short>ООО<
<short>ЗАО</short>
            </opf>
            <name>
                <latin/>
                
<full>ХФ ЛАБС<
<full>ВОЛЫ</full>
                
<short
<short>Волы</
>
short>
            </name>
            
<inn>7707545900<
<inn>7709420914</inn>
            
<ogrn>1057746629115<
<ogrn>1037709040753</ogrn>
            
<okpo
<okpo>14224803</
>
okpo>
            
<okved
<okved>63.40</
>
okved>
            <state>
                <status>ACTIVE</status>
                <registration_
date>1113163200000<
date>1052164800000</registration_date>
                <liquidation_date/>
            </state>
        </data>
    </suggestions>
</SuggestResponse>