post https://api.sendios.io/v1/email/check
АРІ-точка для валідації поштової адреси користувача та приведення її до правильного формату (за можливості та необхідності). Ця АРI-точка НЕ створює нового користувача у системі.
У відповідь АРІ-точка повертає інформацію про електронну адресу користувача:
| Response params | Description |
|---|---|
| reason | Причина невалідності пошти (тільки якщо valid = false); |
| orig | Оригінальна електронна адреса користувача; |
| valid | Валідна електронна адреса: true / false; |
| Електронна адреса користувача, яку буде збережено; | |
| vendor | Поштовик: AOL, Google, Mail.ru, Hotmail, Yahoo!, Rambler, Apple, Ukr.net тощо; |
| domain | Домен поштовика; |
| trusted | true / false (цей параметр визначає, чи є вендор поштової адреси перевіреним, наприклад, загальновідомі вендори, такі як Google, Mail.ru, Оutlook, матимуть значення trusted = true. Якщо у нас немає інформації про домен поштової адреси, то значення trusted = false). |
Потенційні причини невалідності пошти:
| Reason value | Description |
|---|---|
| invalid | Неправильний формат електронної адреси; |
| mx_record | Відсутній mx-запис для домену пошти; |
| application | Пошта відноситься до додатку (наприклад, fb.com); |
| system | Системна пошта (наприклад, [email protected]); |
| blacklisted | Пошта знаходиться в чорному списку (blacklist); |
| mx_record_blacklisted | Mx-запис пошти знаходиться в чорному списку (blacklist); |
| mx_ip_blacklisted | IP-адреса mx запису знаходиться в чорному списку (blacklist). |
Запис MX (від англ. mail exchanger) – тип запису DNS, який зберігає сервер обміну поштою для домену та призначений для маршрутизації електронної пошти з використанням протоколу SMTP.
Докладну інформацію щодо процесу валідації електронної адреси ви знайдете у відповідній статті Валідація електронної пошти.