数値リスクスコアの使用を開始する
番号リスクスコアは、電話番号の不正リスクレベルを返します。前提条件を設定し、可用性を確認し、API の入力と出力を確認し、返されたリスク レベルに対処します。
始める前に
数値リスクスコアを使用するには、次のものが必要です。
- NTT CPaaSアカウント。無料アカウントをお持ちでない場合は、サイン アップしてください 。詳細は アカウントの作成 を参照してください。
- 早期アクセスプログラムへの登録。アカウントマネージャーまたは サポート に連絡して、アクセスをリクエストしてください。
- 各 API 呼び出しの前にエンド ユーザーからの明示的な同意。詳細は同意を参照してください。
同意
エンドユーザーは、数値リスクスコアを使用する前に明示的な同意を提供する必要があります。同意は、すべての API 呼び出しで必須です。API を呼び出す前に毎回収集します。
同意の文言とデータ保持の詳細については、「データとプライバシー」を参照してください。
入力
API を呼び出すには、次のパラメーターが必要です。
| パラメータ | 必須 | 説明 |
|---|---|---|
| Phone number (電話番号) | はい | エンド ユーザーの電話番号 (+プレフィックスなしの E.164 形式)。たとえば、639050387416などです。 |
| エンドユーザーの同意 | はい | 電話番号を処理するためにエンドユーザーから提供された明示的な同意。 |
出力
API は、次のパラメーターを返します。
| パラメータ | 説明 |
|---|---|
| 地位 | API リクエストが正常に処理されたかどうか、およびその番号のデータが使用可能かどうかを示します。 |
| リクエストID | API リクエストの一意の識別子。 |
| リスクレベル | 電話番号の全体的なリスク レベル: 低、中、高、または不明。この複合スコアはNTT CPaaSによって計算され、現在の早期アクセスバージョンではクライアントごとに設定することはできません。 |
| 在職期間と最後に見た番号 | 電話番号がNTT CPaaSプラットフォームで最初に表示され、最後に確認された日時。 |
| 運送業者情報 | 番号に関連付けられている国、ネットワーク、および移植されたステータス。 |
| LINEタイプ | 番号に関連付けられている電話回線の種類 (モバイル、固定回線、VoIP など)。値の完全なリストについては、応答属性を参照してください。 |
| 電話番号のベロシティ | 過去 24 時間と 90 日間に電話番号が受信したトラフィック量で、それぞれに独自のリスク レベルがあります。 |
| 数値範囲の速度 | 関連付けられた番号が過去 24 時間と 90 日間に受信したトラフィック量の範囲で、それぞれに独自のリスク レベルがあります。番号範囲は 1,000 個の連続した番号をカバーします。 |
| 信頼指標 | 政府機関、銀行、通信事業者などの正当なエンティティとのやり取りに基づいてスコアを獲得します。 |
| ボットのような動作 | 電話番号が過去にチャットボットのような動作を示したかどうかを示します。 |
すべてのフィールドとその可能な値の詳細については、「応答属性」を参照してください。
API は、次のような応答を返します。
json
1{
2 "status": "OK",
3 "requestId": "2444d4e2-ab53-4f77-a5a5-aa97eac5e23",
4 "riskLevel": "MEDIUM",
5 "tenure": {
6 "firstSeen": "2025-08-22",
7 "lastSeen": "2025-08-26"
8 },
9 "carrierInfo": {
10 "originalNetwork": {
11 "networkName": "HT",
12 "networkPrefix": "99",
13 "countryName": "Croatia",
14 "countryPrefix": "385"
15 },
16 "ported": true,
17 "portedNetwork": {
18 "networkName": "Tomato",
19 "networkPrefix": "92",
20 "countryName": "Croatia",
21 "countryPrefix": "385"
22 },
23 "lineType": "MOBILE"
24 },
25 "numberVelocity": {
26 "last24Hours": {
27 "count": 18,
28 "riskLevel": "LOW"
29 },
30 "last90Days": {
31 "count": 26,
32 "riskLevel": "LOW"
33 }
34 },
35 "rangeVelocity": {
36 "last24Hours": {
37 "count": 3209,
38 "riskLevel": "HIGH"
39 },
40 "last90Days": {
41 "count": 3619,
42 "riskLevel": "MEDIUM"
43 }
44 },
45 "trustedInteraction": false,
46 "botLikeBehavior": true
47}
リスクレベルの仕組み
数値リスク・スコアは、低、中、または高のリスク・レベルを返します。数値リスクスコアは、行動シグナルの組み合わせからリスクレベルを導き出します。単一の信号が結果を決定することはありません。
分析されるSignalsは次のとおりです。
- 番号年齢
- トラフィックの異常
- 範囲レベルの攻撃パターン
- 政府機関、銀行、通信会社との信頼できるやり取り
- ボットのような行動指標
電話番号に関するデータがほとんどまたはまったくない場合でも、番号リスクスコアは結果を返します。ゼロ値または欠損値自体は、不正ロジックに組み込むことができる意味のあるシグナルです。
リスクレベルを使用して、各インタラクションのアクションを決定します。
Approve
低リスクの数値の相互作用を許可します。
Step-up
中リスクの数値に対して追加の検証を要求します。
Block
リスクの高い数値のインタラクションを拒否します。