Eine E-Mail-Adresse prüfen
Ob es sich lohnt, an eine Adresse zu senden, vor der ersten Nachricht.
Führt jeden der 2 Aufrufe in Ihrem Workspace aus.
GET /tools/address
Ob es sich lohnt, an eine Adresse zu senden, vor der ersten Nachricht.
Beispiel
Erfordert keinen Scope. result ist valid, risky, invalid oder unknown, und reasons sagt, warum: falsche Schreibweise, eine Domain, die keine E-Mails annimmt, ein Wegwerf- oder Sammelpostfach oder ein wahrscheinlicher Tippfehler, mit der Korrektur in suggestion. Mit emails:read ergänzt workspace, was dieser Workspace über die Adresse weiß.
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"}Eine Adresse mit falscher Schreibweise ist kein Fehler. Die Antwort ist 200 mit result gleich invalid.
deep=true fragt zusätzlich, ob das Postfach existiert, in checks.mailbox. Es erfordert emails:send und wird pro Adresse über Pay-as-you-go abgerechnet. Ist Pay-as-you-go aus, ist es ein 409 deep_check_unavailable, und es wird nichts berechnet.
Eine Liste prüfen
POST /tools/addresses nimmt bis zu 100 Adressen in emails und antwortet mit einer Prüfung für jede, in der Reihenfolge, in der sie gesendet wurden. deep gilt für alle.
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"] } ]}Mehr als 100 Adressen, oder keine, ist ein 422 invalid_parameter für emails.