手机号防骚扰黑名单 - 海宇数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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", "level": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | mobile_no | string | 是 | 11位手机号 | | level | string | 是 | 拦截等级：1一般（仅拦截极敏感号码）；2敏感（拦截有过投诉行为的号码）；3高危（拦截实际有过投诉及有投诉意向的号码，该等级下还可能返回超频号码） | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 | 字段名 | 类型 | 说明 | |--------|------|------| | mobile | string | 脱敏手机号 | | forbid | int | 是否拦截：0 非风险号码不拦截；1 风险号码拦截；2 超频号码拦截（仅拦截等级为 3 时可能出现） | | luckyLevel | string | 吉祥号等级，详见下方说明 | | msg | string | 拦截描述 | ### 吉祥号等级说明 | 吉祥号等级 | 规则 | 描述 | |--------|------|------| | -1 | 非手机号 | - | | 1 | 六位连续相同数字，或四位相同数字+四位相同数字，或连续的 8 位顺增数字 | 建议拦截 | | 2 | 五位连续相同数字或连续的 7 位顺增数字 | 建议拦截 | | 3-1 | 四位连续相同数字，最后一位为 6/7/8/9，或连续的 6 位顺增数字，或两两相同的数字连续出现四次 | 建议拦截 | | 3-2 | 四位连续相同数字 | 建议拦截 | | 4-1 | 三位连续相同数字，最后一位为 6/7/8/9，或连续的 5 位顺增数字 | 可根据需求选择是否拦截 | | 4-2 | 三位连续相同数字 | 可根据需求选择是否拦截 | | 5-1 | 两两相同的数字连续出现三次，或末尾四个为连续的 4 位递增数字 | 可根据需求选择是否拦截 | | 5-2 | 连续的 4 位顺增数字 | 可根据需求选择是否拦截 | | 6 | 两两相同的数字连续出现两次，或者连续的 3 位递增数字 | 可根据需求选择是否拦截 | | 0 | 不符合上述任何一种情况的号码，普通号码 | 可根据需求选择是否拦截 |