获取过滤记录接口
# 1、接口描述
功能说明: 通过此接口可以获取某任务中指定号码的过滤记录数据。单次调用最多返回20条数据
请求地址: https://open-api.soboten.com/apiOpen/v1/filterRecord/getFilterRecord 请求方法: POST
# 2、请求头
请求头参数获取详见权限认证
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| appkey | String | 是 | ISV账号信息里获取 |
| timestamp | Long | 是 | 生成验签字段时使用的时间戳 |
| signature | String | 是 | 验签字段,获取方法详见权限认证 |
# 3、输入参数
| 参数名 | 类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
| robotCallJobId | Integer | 是 | 任务id | 2588 |
| calledPhoneNumber | String | 是 | 联系电话(明文或密文) | ew9fZeBRLVRVEtxE2nSb |
| customerPersonName | String | 否 | 客户名 | 张三 |
| filterType | String | 否 | 过滤类型 详见枚举类型说明中的外呼过滤枚举 | SHARE_WHITE_LIST |
| startTime | String | 否 | 过滤时间(开始时间) | "2025-03-01 00:00:00" |
| endTime | String | 否 | 过滤时间(结束时间) | "2025-03-01 23:59:59" |
# 4、输出参数
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
| code | Integer | 响应码 | 200 |
| data | JsonArray | 结果集 | |
| +filteredRobotCallTaskId | Integer | 过滤记录id | 23013 |
| +robotCallJobId | Integer | 任务id | 1851 |
| +calledPhoneNumber | String | 联系电话 | ew9fZeBRLVRVEtxE2nSb |
| +customerPersonId | Integer | 客户id | 138307658 |
| +customerPersonName | String | 客户名 | 章三 |
| +gender | String | 性别,UNKNOWN(“未知”),MALE( “男”),FEMALE(“女”); | MALE |
| +filterType | String | 过滤类型 | ILLEGAL_TEL |
| +filterReason | String | 过滤原因 | 风控系统不可用 |
| +createTime | String | 过滤时间 | "2024-09-25 17:49:47" |
| +properties | Map | 自定义变量 | { "积分": "100" } |
| requestId | String | 请求Id | PDRAROJB |
| resultMsg | String | 响应说明 | 执行成功 |
| host | String | 业务主机名 | prod-web-7 |
| errorStackTrace | String | 异常堆栈 | null |
# 5、示例
输入示例:
{
"robotCallJobId":32322,
"calledPhoneNumber":"94852749",
"customerPersonName":"张三",
"filterType":"LOREAL_INTERCEPT",
"startTime":"2025-03-03 10:14:56",
"endTime":"2025-03-03 19:14:56"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
输出示例:
{
"code": 200,
"data": [
{
"filteredRobotCallTaskId": 8519146,
"robotCallJobId": 32322,
"calledPhoneNumber": "94852749",
"customerPersonId": 377130100,
"customerPersonName": "张三",
"gender": "MALE",
"filterType": "LOREAL_INTERCEPT",
"filterReason": "黑名单接口调用异常",
"createTime": "2025-03-03 18:14:56",
"properties": {
"积分": "100"
}
}
],
"requestId": "zQOTs31L",
"resultMsg": "执行成功",
"host": "daily-acp-03",
"errorStackTrace": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
上次更新: 2026/8/4 16:22:00