メインコンテンツへスキップ
POST
curl
POST /v3/ip/risk/は、バックエンドがすでにIPアドレスを保持しており、サーバー間でリスク判定を行う必要がある場合に使用します。 レスポンスには、位置情報、ネットワークの所有者情報、VPN/Torおよびデータセンターのフラグ、脅威データが含まれます。申告された国を送信した場合はcountry_mismatchも含まれます。

レスポンスの解釈

  • statusは、解決された国がclaimed_countryと一致しない場合、またはアドレスがVPN、Tor、データセンターのインフラに関連付けられている場合にIn Reviewになります。それ以外の場合はApprovedです。
  • ip.ip_country_codeには解決された国コードが入ります。国の比較は、生の国名文字列を自分で比較するのではなく、ip.country_mismatchを使って行ってください。
  • ip.latitudeとip.longitudeはネットワークに基づくおおよその位置情報であり、デバイスの正確な位置ではありません。
  • ip.is_vpn_or_tor、ip.is_data_center、ip.proxy_type、ip.threatには、ネットワークリスクの根拠が含まれます。
  • ip.asn_number、ip.asn_organization、ip.connection_type、ip.carrierは、アドレスが属するネットワークを表します。
  • request_idはAPIセッションIDです。結果を後続のWebhookやコンソール上のアクティビティと紐付ける必要がある場合は、vendor_dataと一緒に保存してください。
IP情報の付加はベストエフォートです。どの情報源からも使用可能なデータが返されない場合、エンドポイントはip.ip_address: null、ip.country_mismatch: null、空のip.threatオブジェクトを含む承認済みのレスポンスを返します。また、取得できない場合は個々のフィールドがnullになることもあります。

デバイスインテリジェンス

IP Risk APIはサーバー間でのみ利用するエンドポイントです。デバイスフィンガープリントはそうではありません。バックエンドだけではブラウザやデバイスのシグナルを観測できないためです。ホスト型フローおよびSDKのセッションでは、Diditは収集済みのデバイスフィールドをセッションのレスポンスで提供します。これにはdevice_fingerprint、デバイスとブラウザの詳細、user_agent、未加工のデバイスデータ、セッション間の一致が含まれます。

サンドボックスでの動作

サンドボックスキーはリクエストを検証し、決定論的な承認済みデータを返します。外部のインテリジェンスサービスへの接続、クレジットの消費、セッションの作成、Networksへのデータ提供は行いません。

請求

IP Risk APIの呼び出し1回あたりの料金は、定価で$0.02です。本番環境のリクエストは、照会が開始された時点で課金対象になります。

承認

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
ip_address
string<ip>
必須

スコアリング対象のIPv4またはIPv6アドレス。

例:

"8.8.8.8"

claimed_country
string

ユーザーまたはセッションが申告した任意のISO 3166-1 alpha-2またはalpha-3の国です。country_mismatchの算出に使用されます。

Maximum string length: 3
例:

"ESP"

user_agent
string

バックエンドで観測されたユーザーエージェント。リクエストのコンテキストとして保存されます。デバイスフィンガープリントは提供しません。

Maximum string length: 512
vendor_data
string

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

metadata
object | null

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

レスポンス

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

request_id
string<uuid>
必須

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

status
enum<string>
必須

このAPIセッションの判定。ネットワークまたは国の不一致リスクがある場合はIn Review、それ以外はApprovedです。

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

このレスポンスの日時。

vendor_data
string | null

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

metadata
object | null

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

ip
object

IPリスクの結果。照会で利用可能なデータが返されなかった場合、個々のエンリッチメントフィールドはnullになることがあります。

最終更新日 2026年11月1日