1.号码标记查询
1.1 协议说明
1.2请求参数
请求参数Body以 multipart/form-data 方式提交
1.3响应内容
| 字段名 | 类型 | 说明 |
|---|
| code | String | 响应code码。200000：成功，其他失败。 |
| message | String | 响应code码解释 |
| reqId | String | 请求编号 |
| chargeStatus | int | 是否计费，1:收费；0：不收费 |
| chargeCount | String | 计费条数 |
| data | array | 结果数组 |
| msg | String | 调用消息 |
| batch_unique_id | String | 批次 id |
| import_counnt | int | 导入号码数量 |
1.4返回成功示例
{
"code": "200000",
"message": "success",
"reqId": "1810979104077729793",
"chargeStatus": 1,
"chargeCount": "3",
"data": {
"msg": "ok:成功导入号码个数3,批次为:1f3c039dde9adc25db30d232c34eb7ca",
"batch_unique_id": "1f3c039dde9adc25db30d232c34eb7ca",
"import_count": 3
}
}
1.5失败返回示例
{
"code": "200000",
"message": "success",
"reqId": "1810979104077729795",
"chargeStatus": 0,
"chargeCount": "0",
"data": {
"msg": "无效参数:139262526 号码格式错误",
"batch_unique_id": null,
"import_count": null
}
}
1.6 回调字段及格式
字段描述
| 字段名 | 类型 | 说明 |
|---|
| batch_unique_id | String | 批次 |
| batch_status | String | 批次状态 1.未完成,2:已完成 |
| phone | String | 号码 |
| status | String | 号码状态 1.查询中 2.查询完成 |
| mobile_housekeeper_name | String | 腾讯手机管家内容 |
| mobile_housekeeper_times | String | 腾讯手机管家次数 |
| mobile_housekeeper_show_name | String | 腾讯手机管家展示名称 |
| security_guard_name | String | 360 搜索记内容 |
| security_guard_times | String | 360 搜索标记次数 |
| security_guard_show_name | String | 360 搜索展示名称 |
| telephone_bond_name | String | 电话邦标记内容 |
| telephone_bond_times | String | 电话邦标记次数 |
| telephone_bond_show_name | StringString | 电话邦展示名称 |
| mobile_guard_name | String | 百度搜索标记内容 |
| mobile_guard_times | String | 百度搜索标记次数 |
| mobile_guard_show_name | String | 百度搜索展示名称 |
| date | String | 日期 |
| create_time | String | 号码导入时间 |
回调格式
格式化json字符串后如下：
[
{
"date": "2024-06-14",
"mobile_guard_name": "",
"telephone_bond_times": "",
"mobile_housekeeper_name": "",
"security_guard_times": "",
"create_time": "2024-06-14 11:49:35",
"mobile_guard_show_name": "",
"batch_status": "查询完成",
"batch_unique_id": "1f3c039dde9adc25db30d232c34eb7ca",
"telephone_bond_name": "",
"telephone_bond_status": "查询完成",
"security_guard_show_name": "",
"mobile_housekeeper_show_name": "",
"mobile_guard_status": "查询完成",
"mobile_housekeeper_status": "查询完成",
"security_guard_status": "查询完成",
"phone": "13926252622",
"mobile_housekeeper_times": "",
"security_guard_name": "",
"telephone_bond_show_name": "",
"status": "查询完成"
},
{
"date": "2024-06-14",
"mobile_guard_name": "",
"telephone_bond_times": "",
"mobile_housekeeper_name": "",
"security_guard_times": "",
"create_time": "2024-06-14 11:49:35",
"mobile_guard_show_name": "",
"batch_status": "查询完成",
"batch_unique_id": "1f3c039dde9adc25db30d232c34eb7ca",
"telephone_bond_name": "",
"telephone_bond_status": "查询完成",
"security_guard_show_name": "",
"mobile_housekeeper_show_name": "",
"mobile_guard_status": "查询完成",
"mobile_housekeeper_status": "查询完成",
"security_guard_status": "查询完成",
"phone": "13926252623",
"mobile_housekeeper_times": "",
"security_guard_name": "",
"telephone_bond_show_name": "",
"status": "查询完成"
},
{
"date": "2024-06-14",
"mobile_guard_name": "",
"telephone_bond_times": "",
"mobile_housekeeper_name": "",
"security_guard_times": "",
"create_time": "2024-06-14 11:49:35",
"mobile_guard_show_name": "",
"batch_status": "查询完成",
"batch_unique_id": "1f3c039dde9adc25db30d232c34eb7ca",
"telephone_bond_name": "",
"telephone_bond_status": "查询完成",
"security_guard_show_name": "",
"mobile_housekeeper_show_name": "",
"mobile_guard_status": "查询完成",
"mobile_housekeeper_status": "查询完成",
"security_guard_status": "查询完成",
"phone": "13926252624",
"mobile_housekeeper_times": "",
"security_guard_name": "",
"telephone_bond_show_name": "",
"status": "查询完成"
}
]
附录一：回调接口示例
回调接口示例代码（Java），一定要严格按照这个格式返回
@Slf4j
@Validated
@RestController
@RequestMapping("/numMark")
public class NumMarkCallBackTestController {
@PostMapping("/callBack")
public CallBackResult callBack(String data) throws Throwable {
JSONArray jsonArray = JSON.parseArray(data);
log.info("接收号码标记查询回调成功啦!!!回调结果:{}", JSON.toJSONString(jsonArray));
//业务处理
......
return CallBackResult.ok();
}
}
CallBackResult类
（注意：用户可直接在代码中使用CallBackResult类封装响应结果。
如用户自定义响应类，状态码也必须和CallBackResult类中的状态码一致，否则会导致回调异常。）
@Data
@NoArgsConstructor
@AllArgsConstructor
public class CallBackResult {
private String code;
private String msg;
public static CallBackResult ok() {
return new CallBackResult("200", "success");
}
public static CallBackResult fail() {
return new CallBackResult("500", "fail");
}
}
附录二：号码格式说明
| 号码类型 | 说明 |
|---|
| 固话 | 区号+7~8 位号码 |
| 手机号 | 11 位手机号码 |
| 96 号码 | 加区号，尾数不少于 3 位 |
| 95 号码 | 不加区号，尾数不少于 3 位 |
| 400 号码 | 不加区号，号码长度不少于 10 位 |
| 1010 号码 | 不加区号，号码长度不少于 8 位 |
| 116、118 | 号码长度不少于 4 位 |
| 1019 号码 | 不加区号，1019 开头的号码 |
没有更多了
