天远号码特别风险核验 - 天远API

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | Access-Id | string | 是 | 账号的 Access-Id | 对于业务请求参数 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`，以此方式进行传参。 ```json { "data": "xxxx(base64)" } ``` 对接响应得到的公共参数 ```json { "code": "int", "message": "string", "transaction_id": "string", // 流水号 "data": "string" } ``` **data** 字段为加密的数据，需要解密后查看。 ## 加密和解密机制 账户获得的密钥（**Access Key**）是一个 16 进制字符串，使用 AES-128 加密算法。 ### 加密过程： - 加密模式：**AES-CBC 模式**。 - 密钥长度：**128 位（16 字节）**。 - 填充方式：**PKCS7 填充**。 - **IV（初始化向量）**：IV 长度为 16 字节（128 位），每次加密时随机生成。 - 加密后，将 **IV** 和密文拼接在一起进行传输。 - 最后，将拼接了 IV 的密文通过 **Base64 编码**，方便在网络或文件中传输。 ### 解密过程： - 解密时，首先从 Base64 解码后的数据中提取前 16 字节作为 **IV**。 - 然后使用提取的 **IV**，通过 AES-CBC 模式解密剩余部分的密文。 - 解密后去除 **PKCS7 填充**，即可得到原始明文。

## 请求参数 ```json { "mobile_no": "string" ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | mobile_no | string | 是 | 手机号 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 | 参数名称 | 描述与备注 | | --- | --- | | `phonePrimaryInfo` | 手机号基础信息，Object 类型，包含手机号归属地、运营商等基础信息。 | | `phonePrimaryInfo.intl_phone_country` | 手机号国家 / 地区，数组类型，手机号所属国家。示例：`["中国"]` | | `phonePrimaryInfo.phone_province` | 手机号省份，String 类型，手机号归属省份。示例：广西 | | `phonePrimaryInfo.phone_city` | 手机号城市，String 类型，手机号归属城市。示例：南宁 | | `phonePrimaryInfo.phone_operator` | 手机号运营商，String 类型，手机号所属运营商。示例：移动 | | `phoneRiskLabels` | 手机号风险标签信息，Array [Object] 类型，该手机号关联的风险标签信息；无风险时返回 `null`。 | | `phoneRiskLabels[].description` | 风险描述文本，String 类型，风险标签可读中文描述。示例：手机号关联风险设备:手机号关联可疑设备:VPN设备手机号 | | `phoneRiskLabels[].label1` | 一级风险标签编码，String 类型，第一级风险标签编码。示例：`relate_riskdevice_phone` | | `phoneRiskLabels[].label2` | 二级风险标签编码，String 类型，第二级风险标签编码。示例：`suspicious_device_phone` | | `phoneRiskLabels[].label3` | 三级风险标签编码，String 类型，第三级风险标签编码。示例：`b_vpn_phone` | | `phoneRiskLabels[].timestamp` | 风险产生时间戳，Number 类型，毫秒级 Unix 时间戳，代表该风险记录生成时间。示例：`1764093786500` |