Skip to content

If you're interested in the English version of this spec, let us know on the GitHub.

email


Подсказки по email

POST
/suggest/email
  • Подсказывает локальную часть (до «собачки»).
  • Подсказывает доменную часть (после «собачки»).
  • Исправляет опечатки (yadex.ru → yandex.ru).

Authorizations

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Type
API Key (header: Authorization)

Request Body

application/json
object

Текст запроса.
@maxLength 300

Max Length300

Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10

Minimum1
Maximum20
Default10

Responses

Запрос успешно обработан

application/json
object

Объект с массивом подсказок

object[]
Required

Массив подсказок или пустой массив

Email одной строкой

= value

object
Required

Подробности об email

Playground

Server
Authorization
Body

Samples


Стандартизация email

POST
/clean/email
  • Проверяет формат адреса.
  • Исправляет распространённые опечатки.
  • Проверяет, не «одноразовый» ли адрес.
  • Классифицирует адреса на личные (@mail.ru, @yandex.ru), корпоративные (@myshop.ru) и «ролевые» (info@, support@).

Authorizations

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Type
API Key (header: Authorization)
+
SecretKey

Секретный ключ

Type
API Key (header: X-Secret)

Request Body

application/json

Формат запроса ко всем эндпоинтам API стандартизации (clean) «Дадаты»,
кроме стандартизации составной записи https://dadata.ru/api/clean/record/

Все эндпоинты поддерживают стандартизацию только одной записи в одном запросе, например:
@example [ "мск сухонска 11/-89" ] // Адрес - https://dadata.ru/api/clean/address/
@example [ "Срегей владимерович иванов" ] // ФИО - https://dadata.ru/api/clean/name/
@example [ "serega@yandex/ru" ] // Email - https://dadata.ru/api/clean/email/
@example [ "раб 846)231.60.14 *139" ] // Телефон - https://dadata.ru/api/clean/phone/
@example [ "4509 235857" ] // Проверка паспорта - https://dadata.ru/api/clean/passport/
@example [ "24/3/12" ] // Дата - https://dadata.ru/api/clean/birthdate/
@example [ "форд фокус" ] // Марка и модель автомобиля - https://dadata.ru/api/clean/vehicle/

Min Items1
Max Items1

Responses

Запрос успешно обработан

application/json
object[]
Min Items1
Max Items1

Исходный email

Стандартизованный email

Локальная часть адреса (то, что до «собачки»)

Домен (то, что после «собачки»)

Тип адреса

  • PERSONAL — личный (@mail.ru, @yandex.ru)
  • CORPORATE — корпоративный (@myshop.ru)
  • ROLE — «ролевой» (info@, support@)
  • DISPOSABLE — одноразовый (@temp-mail.ru)
Valid valuesnull"PERSONAL""CORPORATE""ROLE""DISPOSABLE"

Код проверки. Подходит ли email для маркетинговой рассылки:

Код Нужно проверить вручную? Описание
0 Нет Корректный адрес (по общим правилам; существование не проверяется)
1 ДА Некорректное значение (синтаксически)
2 Нет Пустой или заведомо «мусорный»
3 Нет «Одноразовый» адрес (по списку известных доменов)
4 ДА Исправлены опечатки
Valid values01234

Playground

Server
Authorization
Body

Samples


Powered by VitePress OpenAPI