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

Помогает человеку быстро ввести адрес эл. почты на веб-форме или в приложении.

Что умеет:

✔️ Подсказывает локальную (до «собачки») и доменную (после «собачки») части эл. почты.

✔️ Исправляет опечатки (yadex.ruyandex.ru).

Не умеет:

❌ Автоматически (без участия человека) проверить адреса из базы или файла.

❌ Классифицировать адреса на личные (@mail.ru, @yandex.ru), корпоративные (@myshop.ru) и «ролевые» (info@, support@).

Подсказки не подходят для автоматической обработки email. Они предлагают варианты, но не гарантируют, что угадали правильно. Поэтому окончательное решение всегда должен принимать человек.

Запрос

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:

ПолеТип данных

Описание

valuestring(1000)Адрес эл. почты одной строкой
unrestricted_valuestring(1000)= value
data.localstring(100)Именная часть
data.domainstring(100)Доменная часть
Не используются

data.type
начиная с версии 20.2
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