获取案件列表
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID |
a5fc6490-ef1e-4666-870a-07a4e586c414 |
| PageNumber |
integer |
是 |
页码 |
1 |
| PageSize |
integer |
是 |
每页条数 |
10 |
| StartTime |
integer |
否 |
开始时间 |
1578965079000 |
| EndTime |
integer |
否 |
结束时间 |
1578995079000 |
| CampaignId |
string |
否 |
外呼活动 ID |
7607dae1-91ad-47ea-ad76-3d81ac34f729 |
| CaseIds |
array |
否 |
案例 ID 列表 |
|
|
string |
否 |
案件 ID |
7607dae1-91ad-47ea-ad76-3d81ac34f700 |
|
| Caller |
string |
否 |
主叫号码 |
01080862792 |
| PhoneNumber |
string |
否 |
被叫号码 |
18512345678 |
| LabelSearch |
object |
否 |
标签搜索条件 |
|
|
string |
否 |
标签 |
软包装企业打电话_20251022_165548 |
|
| CaseCompleted |
boolean |
否 |
案例是否完成 |
true |
| MinRingingDuration |
integer |
否 |
最小振铃时长 |
1 |
| MaxRingingDuration |
integer |
否 |
最大振铃时长 |
2 |
| MinTalkTime |
integer |
否 |
最小通话时长 |
1 |
| MaxTalkTime |
integer |
否 |
最大通话时长 |
2 |
| MinTalkTurns |
integer |
否 |
最小对话轮次 |
1 |
| MaxTalkTurns |
integer |
否 |
最大对话轮次 |
2 |
| AccessChannelId |
string |
否 |
接入渠道 ID |
33606503-c22c-4547-a51c-dda5e8d87962 |
| AccessChannelType |
string |
否 |
接入渠道类型 |
Test |
| DraftVersion |
boolean |
否 |
是否草稿版本 |
true |
| ScriptId |
string |
否 |
话术 ID |
c5c5d8c0-c0f1-48a7-be2b-dc46006d888a |
| States |
array |
否 |
案例状态列表 |
|
|
string |
否 |
案例状态 |
Pending |
|
| DispositionCodes |
array |
否 |
结果编码列表 |
|
|
string |
否 |
联络结果代码列表。 |
Answered |
|
| DispositionReasons |
array |
否 |
结果原因列表 |
|
|
string |
否 |
联络结果描述列表。 |
Busy |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| HttpStatusCode |
integer |
HTTP 状态码 |
200 |
| Code |
string |
错误码 |
OK |
| Message |
string |
错误信息 |
Success |
| RequestId |
string |
请求 ID |
C377C5FF-4F94-1B23-89D0-50C560623EE4 |
| Success |
boolean |
是否成功 |
true |
| Data |
object |
分页数据 |
|
| TotalCount |
integer |
总记录数 |
30 |
| PageNumber |
integer |
当前页码 |
1 |
| PageSize |
integer |
每页条数 |
20 |
| List |
array<object> |
案例列表 |
|
|
array<object> |
返回对象 |
||
| CaseId |
string |
案例 ID |
00ed0dd9-c5a4-40e4-a8cd-822f0af859b9 |
| CreatedTime |
integer |
创建时间 |
2025-07-27T11:25:15+08:00 |
| CampaignId |
string |
外呼活动 ID |
7607dae1-91ad-47ea-ad76-3d81ac34f729 |
| CampaignName |
string |
外呼活动名称 |
e2d7a184-7d6c-45d4-ac24-34ab48f54600 |
| InstanceId |
string |
实例 ID |
e2d7a184-7d6c-45d4-ac24-34ab48f54669 |
| ReferenceId |
string |
引用 ID |
5055-16-199313 |
| PhoneNumber |
string |
被叫号码 |
18512345678 |
| State |
string |
案例状态 |
Executing |
| AttemptedCount |
integer |
拨打次数 |
1 |
| CustomVariables |
string |
自定义变量（JSON 字符串） |
{} |
| LastAttemptedTime |
integer |
最后拨打时间 |
1786960840667 |
| Priority |
integer |
优先级 |
Daily |
| SessionId |
string |
最后通话会话 ID |
SESSION_ID_312986372_7295954260941888 |
| DialingTime |
integer |
拨号时间 |
1786960840667 |
| RingingTime |
integer |
振铃时间 |
1786960840667 |
| RingingDuration |
integer |
振铃时长 |
25 |
| TalkTime |
integer |
通话时长 |
10 |
| CallerNumber |
string |
主叫号码 |
05923395478 |
| ScriptId |
string |
话术 ID |
8a988bd4-6c6e-45c6-b3a5-3def5ca3bc6f |
| ScriptName |
string |
话术名称 |
场景名称 |
| DispositionCode |
string |
结果编码 |
Answered |
| DispositionReason |
string |
结果原因 |
Normal |
| Labels |
array<object> |
标签列表 |
|
|
object |
命中的标签值 |
||
| Name |
string |
标签名称 |
软包装企业打电话_20251022_165548 |
| Description |
string |
标签描述 |
描述内容 |
| CandidateValues |
array |
标签候选值 |
|
|
string |
标签可选值 |
1 |
|
| MatchedValue |
string |
标签匹配值 |
1 |
| System |
boolean |
系统标签 |
false |
| Collected |
boolean |
是否被收集 |
true |
| Params |
array |
透传参数 |
|
|
string |
错误信息中的变量值 |
4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b04 |
示例
正常返回示例
JSON格式
{
"HttpStatusCode": 200,
"Code": "OK",
"Message": "Success",
"RequestId": "C377C5FF-4F94-1B23-89D0-50C560623EE4",
"Success": true,
"Data": {
"TotalCount": 30,
"PageNumber": 1,
"PageSize": 20,
"List": [
{
"CaseId": "00ed0dd9-c5a4-40e4-a8cd-822f0af859b9",
"CreatedTime": 0,
"CampaignId": "7607dae1-91ad-47ea-ad76-3d81ac34f729",
"CampaignName": "e2d7a184-7d6c-45d4-ac24-34ab48f54600",
"InstanceId": "e2d7a184-7d6c-45d4-ac24-34ab48f54669",
"ReferenceId": "5055-16-199313",
"PhoneNumber": "18512345678",
"State": "Executing",
"AttemptedCount": 1,
"CustomVariables": "{}",
"LastAttemptedTime": 1786960840667,
"Priority": 0,
"SessionId": "SESSION_ID_312986372_7295954260941888",
"DialingTime": 1786960840667,
"RingingTime": 1786960840667,
"RingingDuration": 25,
"TalkTime": 10,
"CallerNumber": "05923395478",
"ScriptId": "8a988bd4-6c6e-45c6-b3a5-3def5ca3bc6f",
"ScriptName": "场景名称",
"DispositionCode": "Answered",
"DispositionReason": "Normal",
"Labels": [
{
"Name": "软包装企业打电话_20251022_165548",
"Description": "描述内容",
"CandidateValues": [
"1"
],
"MatchedValue": "1",
"System": false,
"Collected": true
}
]
}
]
},
"Params": [
"4f9a8e2b-6c1d-4a7e-9b3f-2d5c8a1e7b04"
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。