Проверить адрес электронной почты
Стоит ли писать на адрес, ещё до первого письма.
Выполняет любой из 2 запросов в вашем рабочем пространстве.
GET /tools/address
Стоит ли писать на адрес, ещё до первого письма.
Пример
Не требует scope. result равен valid, risky, invalid или unknown, а reasons объясняет почему: неверное написание, домен, который не принимает почту, одноразовый или общий ящик либо вероятная опечатка, с исправлением в suggestion. С emails:read поле workspace добавляет то, что это рабочее пространство знает об адресе.
curl "$OE/tools/[email protected]" -H "$AUTH"{ "object": "address_check", "email": "[email protected]", "normalized": "[email protected]", "result": "risky", "reasons": ["typo_suspected"], "suggestion": "[email protected]", "checks": { "syntax": true, "mx": { "status": "found", "hosts": ["mx.gmial.com"] }, "nullMx": false, "disposable": false, "role": false, "freeProvider": false, "mailbox": null }, "workspace": { "suppressed": false, "lastBouncedAt": null, "lastDeliveredAt": null }, "checkedAt": "2026-10-11T09:41:00.000Z"}Адрес с неверным написанием не является ошибкой. Ответ будет 200 с result, равным invalid.
deep=true дополнительно спрашивает, существует ли ящик, в checks.mailbox. Для него нужен emails:send, и он оплачивается за каждый адрес через оплату по факту. Если оплата по факту выключена, это 409 deep_check_unavailable, и ничего не списывается.
Проверить список
POST /tools/addresses принимает до 100 адресов в emails и отвечает одной проверкой на каждый, в том порядке, в каком они были отправлены. deep применяется ко всем.
curl -X POST "$OE/tools/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "list", "data": [ { "object": "address_check", "email": "[email protected]", "result": "valid", "reasons": [] }, { "object": "address_check", "email": "[email protected]", "result": "risky", "reasons": ["role_address"] } ]}Больше 100 адресов или ни одного даёт 422 invalid_parameter для emails.