API
メールアドレスを確認する
最初のメッセージを送る前に、そのアドレスに送信する価値があるかどうか。
GET/tools/address
2件の呼び出しをワークスペースに対して実行します。
GET /tools/address
最初のメッセージを送る前に、そのアドレスに送信する価値があるかどうか。
例
スコープは不要。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"}構文が誤っているアドレスはエラーではない。result が invalid の 200 を返す。
deep=true は、メールボックスが存在するかどうかも確認し、結果は checks.mailbox に入る。emails:send が必要で、従量課金でアドレスごとに請求される。従量課金がオフの場合は 409 deep_check_unavailable になり、請求は発生しない。
リストを確認する
POST /tools/addresses は emails に最大 100 件のアドレスを受け取り、送られた順に、1件ずつの確認結果を返す。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 件を超える場合や1件もない場合は、emails に対する 422 invalid_parameter になる。