1.接口说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 地址 | https://api.cxlnk.com/api/checkMobile/forbidCheck |
| Accept | application/json |
| Content-Type | application/json;charset=utf-8 |
2.请求参数说明
响应 body 数据为 JSON 格式
| 列表 | 内容 | 备注 |
|---|---|---|
| accessKey | API调用账号(必填,String类型,从灿星云平台获取) | |
| accessSecret | API调用密钥(必填,String类型,从灿星云平台获取) | |
| phone | 手机号码,数组格式(必填) | 多个号码以英文半角逗号分隔,支持最多 500 个 |
| forbidLevel | 拦截等级(1:一般 2:敏感 3:高危) (必填) | 高危:拦截实际有过投诉行为的号码、有投诉意向的号码 敏感:拦截有过投诉行为的号码 一般:仅拦截极敏感的号码 |
3.请求参数示例
{
"accessKey": "NDYw*******",
"accessSecret": "MDQyOTQ1OTM3*********************",
"phone":["137xxxx","138xxxx"],
"forbidLevel":1
}
4.响应参数列表
| 列表 | 内容 | 备注 |
|---|---|---|
| code | 状态码200则为成功 | |
| msg | 状态说明 | |
| success | 处理是否成功:取值范围 true,false | |
| data | 业务数据 如果失败则为空 | |
| +msg | 中文描述:非风险号码 风险号码需拦截 超频号码需拦截 | |
| +luckyLevel | 吉祥号等级 | 详见附录 |
| +mobile | 手机号码 | |
| +forbid | 是否拦截,0: 非风险号码,不拦截,1: 风险号码,拦截,2:超频号码,拦截(拦截等级为 3 时才会有超频校验,不走万数过滤的号码不会进行计数 |
5.响应参数示例
{
"code": 200,
"msg": "成功",
"success": true,
"data": "[
{
"msg":"非风险号码",
"luckyLevel":"6",
"mobile":"137xxxx",
"forbid":0
},
{
"msg":"非风险号码",
"luckyLevel":"-1",
"mobile":"138xxxx",
"forbid":0
}
]"
}
6.结果码说明
| 结果码 | 描述 |
|---|---|
| 200 | 成功 |
| 500,501,503 | 系统错误 |
| 502 | 系统繁忙 |
| 60021 | 余额不足,请充值后重试! |
| 10000 | 内部系统出错,请联系厂商 |
7.附录
| -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 | 不符合上述任何一种情况的号码,普通号码 | 根据客户需求酌情选择是否拦截:比如高危情况建议所有吉祥号都拦截 |