Page tree
Skip to end of metadata
Go to start of metadata

Запрос

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "sacred_grove@" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/email

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "sacred_grove@" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/email 

Заголовки

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

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

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

API-ключ в формате: Token ВАШ_КЛЮЧ

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

Параметры

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

Ответ

Возвращается список объектов e-mail:


Поле

Описание

valueEmail одной строкой (как показывается в списке подсказок)
unrestricted_valueEmail одной строкой (полный)
data.localИменная часть
data.domainДоменная часть
Не используются
data.source
data.qc

Примеры

Запрос:

{
  "query": "sacred_grove@",
  "count": 7
} 

Ответ:

{
    "suggestions": [
        {
            "value": "sacred_grove@mail.ru",
            "unrestricted_value": "sacred_grove@mail.ru",
            "data": {
                "local": "sacred_grove",
                "domain": "mail.ru",
                "qc": null
            }
        },
        {
            "value": "sacred_grove@yandex.ru",
            "unrestricted_value": "sacred_grove@yandex.ru",
            "data": {
                "local": "sacred_grove",
                "domain": "yandex.ru",
                "qc": null
            }
        },
        {
            "value": "sacred_grove@pochta.ru",
            "unrestricted_value": "sacred_grove@pochta.ru",
            "data": {
                "local": "sacred_grove",
                "domain": "pochta.ru",
                "qc": null
            }
        }
    ]
}

Запрос:

<req>
    <query>sacred_grove@</query>
    <count>7</count>
</req>

Ответ:

<SuggestResponse>
    <suggestions>
        <value>sacred_grove@mail.ru</value>
        <unrestricted_value>sacred_grove@mail.ru</unrestricted_value>
        <data>
            <local>sacred_grove</local>
            <domain>mail.ru</domain>
            <qc/>
        </data>
    </suggestions>
    <suggestions>
        <value>sacred_grove@yandex.ru</value>
        <unrestricted_value>sacred_grove@yandex.ru</unrestricted_value>
        <data>
            <local>sacred_grove</local>
            <domain>yandex.ru</domain>
            <qc/>
        </data>
    </suggestions>
    <suggestions>
        <value>sacred_grove@pochta.ru</value>
        <unrestricted_value>sacred_grove@pochta.ru</unrestricted_value>
        <data>
            <local>sacred_grove</local>
            <domain>pochta.ru</domain>
            <qc/>
        </data>
    </suggestions>
</SuggestResponse>


  • No labels