Bir e-posta adresini kontrol etme
İlk iletiden önce, bir adrese göndermeye değip değmeyeceği.
2 çağrıdan herhangi birini çalışma alanınızda çalıştırır.
GET /tools/address
İlk iletiden önce, bir adrese göndermeye değip değmeyeceği.
Örnek
Scope gerektirmez. result değeri valid, risky, invalid ya da unknown olur ve reasons nedenini söyler: hatalı yazım, posta kabul etmeyen bir alan adı, tek kullanımlık ya da ortak bir posta kutusu veya olası bir yazım hatası; düzeltmesi suggestion içindedir. emails:read ile workspace, bu çalışma alanının adres hakkında bildiklerini ekler.
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"}Yazımı hatalı bir adres hata değildir. result değeri invalid olarak 200 yanıtı döner.
deep=true, posta kutusunun var olup olmadığını da checks.mailbox içinde sorar. emails:send gerektirir ve kullandıkça öde üzerinden adres başına ücretlendirilir. Kullandıkça öde kapalıyken 409 deep_check_unavailable döner ve hiçbir ücret alınmaz.
Bir listeyi kontrol etme
POST /tools/addresses, emails içinde 100 adrese kadar alır ve her biri için, gönderildikleri sırayla bir kontrol döndürür. deep hepsine uygulanır.
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'den fazla adres ya da hiç adres olmaması, emails için 422 invalid_parameter döndürür.