Kalo te dokumentacioni
API

Kontrolloni një adresë emaili

Nëse ia vlen të dërgohet te një adresë, para mesazhit të parë.

GET/tools/address

Ekzekuton cilëndo nga 2 thirrjet në hapësirën tuaj të punës.

GET /tools/address

Nëse ia vlen të dërgohet te një adresë, para mesazhit të parë.

Shembull

Nuk kërkon scope. result është valid, risky, invalid ose unknown, dhe reasons tregon pse: sintaksë e gabuar, një domen që nuk pranon postë, një kuti e përkohshme ose e përbashkët, apo një gabim i mundshëm shkrimi, me korrigjimin te suggestion. Me emails:read, workspace shton çfarë di kjo hapësirë pune për adresën.

curl
curl "$OE/tools/[email protected]" -H "$AUTH"
Përgjigje
{  "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"}

Një adresë me sintaksë të gabuar nuk është gabim. Përgjigjet me 200 dhe result të vendosur në invalid.

deep=true pyet edhe nëse kutia ekziston, te checks.mailbox. Kërkon emails:send dhe faturohet për adresë përmes pagesës sipas përdorimit. Me pagesën sipas përdorimit të fikur jep 409 deep_check_unavailable, dhe asgjë nuk faturohet.

Kontrolloni një listë

POST /tools/addresses merr deri në 100 adresa te emails dhe përgjigjet me një kontroll për secilën, sipas radhës që u dërguan. deep vlen për të gjitha.

curl
curl -X POST "$OE/tools/addresses" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "emails": ["[email protected]", "[email protected]"] }'
Përgjigje
{  "object": "list",  "data": [    { "object": "address_check", "email": "[email protected]", "result": "valid", "reasons": [] },    { "object": "address_check", "email": "[email protected]", "result": "risky", "reasons": ["role_address"] }  ]}

Më shumë se 100 adresa, ose asnjë, jep 422 invalid_parameter te emails.

Referencë