بررسی یک نشانی ایمیل
اینکه فرستادن به یک نشانی می‌ارزد یا نه، پیش از نخستین پیام.
هر کدام از 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 است.