数値リスクスコア応答属性

このページでは、数値リスクスコア API レスポンスのすべてのフィールドについて、API リファレンスよりも詳細に説明します。これを使用して、各属性の意味、返される値、および詐欺ロジックでそれを解釈する方法を理解します。

前提条件、入力パラメータ、およびリスク・レベルでの対処方法については、「数値リスク・スコアの概要」を参照してください。

要求と応答の構造

電話番号を API に送信すると、このページで説明されているすべてのフィールドを含む 1 つの応答オブジェクトを受け取ります。

最上位フィールド

これらのフィールドは、要求の結果と電話番号の全体的なリスク評価について説明します。

キャリア情報

carrierInfo オブジェクトは、番号に関連付けられたネットワーク、国、移植ステータス、および回線タイプを記述します。

番号年齢

tenureオブジェクトは、NTT CPaaSプラットフォームでその数が観察された期間を示します。初めて見た数値、または履歴のない数値は、確立された数値よりも強いリスクシグナルです。

数値の速度

numberVelocityオブジェクトは、この特定の電話番号が受信したトラフィック量を、時間枠ごとに個別のリスクレベルとともに報告します。各リスクレベルは、その国の一般的な電話番号の行動に関連しています。

範囲速度

rangeVelocityオブジェクトは、番号の 1K 範囲で受信したトラフィック量を報告します。1K 範囲は、クエリされた番号が属する 1,000 個の連続した番号のブロックです。たとえば、5512345678の範囲は5512345で、5512345000から5512345999までの数字をカバーします。高い射程速度は、単一の数字が正常に見える場合でも、数字のブロック全体にわたる協調的な攻撃を明らかにすることができます。

信頼と行動のシグナル

これらのトップレベルのシグナルは、全体的なリスクを逆方向に調整します:信頼できるインタラクションはリスクを低下させますが、チャットボットのような行動はリスクを高めます。

動作とエッジケース

応答を解釈するときは、次の点に留意してください。

• 同意が必要です。 すべてのルックアップには、API 呼び出しの前にユーザーが収集したエンド ユーザーの明示的な同意が必要です。データとプライバシーを参照してください。
• データ ウィンドウ。 速度分析は、過去 90 日間のみを対象としています。在職期間などのその他の属性は、電話番号がその 90 日間の期間内にアクティビティがある限り、引き続き使用できます。すべてのデータは、すべてのチャネルにわたるNTT CPaaSトラフィックから取得されます。
• データの有効期限。 90 日間やり取りがないと、その期間を過ぎるとモバイル ネットワーク オペレーターが番号をリサイクルする可能性があるため、データは使用できなくなります。これは、電話番号が 90 日間まったくアクティブでなかった場合にのみ適用されます。
• プラットフォームの範囲。 riskLevelは、NTT CPaaSが算出した総合スコアです。リスクしきい値のクライアント側構成は、現在の早期アクセスバージョンでは利用できません。