メインコンテンツへスキップ
POST
curl
ユーザーにワンタイムコードの入力を求めずにメールアドレスに関する情報を取得したい場合は、POST /v3/email/risk/を使用します。 このエンドポイントはメールを送信しません。APIセッションを作成し、アドレスの情報を補完し、メールリスクのルールを適用したうえで、メールアドレス認証で使われるものと同じ正規化済みのメールブロックを1回の同期レスポンスで返します。 リクエストが保存されると、Diditはスコアリング済みのメールアドレスをNetworksの集約エビデンスとしても利用できます。ネットワークグラフでは、共有されたメールシグナルについて、高リスクのメールインテリジェンス、漏洩に関するコンテキスト、ソーシャルプロフィールのカバレッジが表示される場合がありますが、メールアドレスそのものが他の組織に開示されることはありません。

レスポンスの解釈

  • statusは、このAPIセッションの最終判定です。通常はApprovedですが、リスク評価の結果In ReviewまたはDeclinedになることがあります。
  • email.is_breached、email.is_disposable、email.is_undeliverableは、アプリケーションロジックで使える安定した「はい/いいえ」のシグナルです。
  • email.breachesは、カバレッジがある場合に、そのアドレスを含む既知の漏洩のうち最新のものを、漏洩日と流出したデータの種類とともに一覧で示します。
  • email.email_intelligence.scoreは0から100のリスクスケールで、数値が大きいほどリスクが高いことを示します。breach_risk_level(Low、Medium、High)とno_of_breachesは、そこから派生した値です。
  • email.email_intelligence.reason_codesは、どの正規化済みシグナルが結果に寄与したかを示します。値は今後増える可能性があるため、未知のコードを拒否しないでください。
  • email.email_intelligenceとemail.enrichmentは、同じ正規化済みオブジェクトを持つ互換性のためのエイリアスです。新しい連携ではemail.enrichmentを参照できます。
  • email.matchesは、同じアドレスが別のユーザーによって使用された、お使いのアプリケーションの他のセッションを一覧で示します。重複アカウントの検出に使用してください。
  • request_idはAPIセッションIDです。後続のWebhookやコンソール上のアクティビティと結果を関連付ける必要がある場合は、vendor_dataとともに保存してください。
email.email_intelligenceとemail.enrichmentはベストエフォートのフィールドです。そのアドレス、ドメイン、またはプランについて利用可能なインテリジェンスデータが返されなかった場合、照会が完了していても両方が省略されることがあります。ルールはまずis_breached、is_disposable、is_undeliverableに基づいて構築し、インテリジェンスが欠落している場合は「安全」ではなく「不明」として扱ってください。

ソーシャルフットプリントアドオン

enable_socialをtrueに設定すると、レスポンスのemailの下にemail_socialブロックが追加されます。このブロックには、このメールアドレスが登録されているオンラインプラットフォームがカテゴリ別に含まれ、集計数と、データパートナーが返すプロフィール詳細も含まれます。
  • email.email_social.profiles_registeredとemail.email_social.profiles_checkedが主要な数値で、評価したプラットフォームのうち、メールアドレスの登録が確認されたプラットフォームの数を示します。
  • email.email_social.registered_platformsとemail.email_social.not_registered_platformsは、各プラットフォームをそのcategoryとscope(global、または地域固有のプラットフォームの場合はlocal)とともに一覧で示します。
  • email.email_social.categoriesはカテゴリごとの登録数と比率を示し、email.email_social.profilesは、プラットフォームが公開している場合にプラットフォームごとのプロフィール詳細(名前、写真URL、自己紹介文、プライバシー設定、ビジネスアカウントのフラグ)を保持します。
  • サマリー指標(digital_footprint_diversity、digital_sophistication_index、engagement_depth_index、subscription_affordability_index)は0から10の複合指標です。チェックでデータが返されなかった場合、各カウントはnullになることがあります。
profiles_registered: 0は失敗ではなく、実際の結果です。プラットフォームはチェックされたものの、どのプラットフォームでもメールアドレスが見つからなかったことを意味し、合成IDによく見られるシグナルです。このエンドポイント自体はこの結果に基づいて何も処理しません。ワークフローでemail_no_social_presence_actionを使用すると、レビューまたは却下の判定に変換できます。 enable_socialが設定されていない場合、このブロックは含まれません。また、ソーシャルチェックを完了できなかった場合も含まれず、その場合は請求されません。

サンドボックスでの動作

サンドボックスのキーはリクエストを検証し、決定論的な承認済みデータを返します。メールの送信、クレジットの消費、セッションの作成、ネットワークには寄与しません。enable_socialを設定した場合は、決定論的なemail_socialブロックも返します。

請求

Email Risk APIの呼び出しは定価で$0.04です。メールを送信しないため、完全なメールアドレス認証よりも安価です。本番環境のリクエストは、一部のベストエフォートフィールドが利用できない場合でも、照会が開始された時点で課金対象になります。 ソーシャルフットプリントアドオンは別途請求されます。チェックが完了するたびに、Email Risk APIの料金に加えてリクエスト1件につきemail_social1単位が請求されます。照会前のクレジットチェックは両方を対象とします。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

ボディ

application/json
email
string<email>
必須

スコアリングするメールアドレス。

例:

"alice@example.com"

country_code
string

インテリジェンスのカバレッジ向けの任意のISO 3166-1 alpha-2またはalpha-3の国ヒントです。

Maximum string length: 3
例:

"US"

signals
object

アプリケーションが観測したデバイスおよびネットワークのコンテキストで、任意指定です。すべてのフィールドは任意です。これらを渡すと、Networksにおけるセッション横断の一致検出に活用されます。

vendor_data
string

このリクエストに対する固定の参照値です。APIセッションに保存され、レスポンスでそのまま返されます。

metadata
object | null

機密性のないJSONメタデータです。APIセッションに保存され、レスポンスでそのまま返されます。

enable_social
boolean
デフォルト:false

trueの場合、アドレスのソーシャルフットプリント(そのアドレスが登録されているメール、ソーシャル、ビジネス、EC、エンターテインメントの各プラットフォーム)も検索します。このエンドポイント自体の料金に加えて、リクエスト1件ごとにemail_social1ユニット分が請求されます。

例:

true

レスポンス

リスク評価が完了しました。判定はstatusで確認してください。完了したルックアップでは、HTTPは常に200です。

request_id
string<uuid>
必須

このリクエストで作成されたAPIセッションのID。結果を後続のWebhookやコンソール上のアクティビティと関連付ける必要がある場合は、vendor_dataとともに保存してください。

status
enum<string>
必須

このAPIセッションの最終判定です。通常はApprovedですが、リスク評価によってIn ReviewまたはDeclinedになる場合があります。

利用可能なオプション:
Approved,
In Review,
Declined
created_at
string<date-time>
必須

このレスポンスの日時。

vendor_data
string | null

送信したvendor_dataのエコー。送信しなかった場合はnullです。

metadata
object | null

送信したmetadataのエコー。送信しなかった場合はnullです。

email
object

正規化されたメールレポート。メールアドレス認証のレスポンスで使われるものと同じブロックです。

最終更新日 2026年11月1日