ईमेल पता जाँचें
पहले संदेश से पहले, किसी पते पर भेजना ठीक रहेगा या नहीं।
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 emails में 100 पते तक लेता है और हर एक के लिए एक जाँच लौटाता है, उसी क्रम में जिसमें वे भेजे गए। 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 से ज़्यादा पते, या एक भी नहीं, emails पर 422 invalid_parameter है।