调用QueryCallDetailByCallId查询指定通话的呼叫详情

查询指定CallID的呼叫详情，包括通话开始时间、通话时长、通话状态、通话结束时间、被叫号码等详情。

接口说明

此接口可查询语音通知、语音验证码、语音 IVR、智能语音交互呼入、智能语音交互、智能外呼机器人的呼叫详情。
获取的 CallId 与 QueryDate 必须是同一天。
获取的 CallId 与 ProdId 参数值必须匹配。

QPS 限制

单用户调用频率：100 次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
CallId	string	是	通话的唯一识别 ID。调用外呼接口发起通话后，返回参数中会携带 CallId。示例：如果您需要查询语音通知的通话记录，请调用 SingleCallByVoice 发送语音通知后获取 CallId。获取的 CallId 与 QueryDate 必须是同一天。示例：CallId 的时间是 2022.11.21，QueryDate 必须也是 2022.11.21 内的时间。获取的 CallId 与 ProdId 参数值必须匹配。示例：CallId 是在发送语音通知后获取的，那 ProdId 参数需要填写语音通知即 11000000300006。	116014888060^10281631****
ProdId	long	是	产品 ID。取值： 11000000300006：语音通知。 11010000138001：语音验证码。 11000000300005：语音 IVR，向指定号码发起交互式语音通话。 11000000300009：语音 SIP。 11030000180001：智能外呼。说明获取的 CallId 与 ProdId 参数值必须匹配。	11000000300006
QueryDate	long	是	通话发生的时间。格式为 Unix 时间戳，单位：毫秒。查询指定时间点之后 24 小时内的通话记录。例如：您输入 2022.11.21 20:00:01（时间戳：1669032001000），系统会查询 2022.11.21 20:00:01~2022.11.22 20:00:01 时间段内指定 callid 的呼叫记录。说明获取的 CallId 与 QueryDate 必须是同一天。	1669032001000

返回参数

名称	类型	描述	示例值
	object	返回数据。
Code	string	请求状态码。返回 OK 代表请求成功。其他错误码，请参见 API 错误码。	OK
Message	string	状态码的描述。	OK
Data	string	返回的呼叫详情。JSON 格式。以下字段仅供参考，以具体返回详情为准。 caller：主叫号码。 startDate：通话开始时间。 stateDesc：通话状态描述。 duration：通话时长。单位：秒。0：用户未接通。 callerShowNumber：被叫显号。 gmtCreate：通话请求的接收时间。 state：通话状态。通话状态是运营商实时返回的，更多状态信息，请参见运营商回执错误码。 endDate：通话结束时间。 calleeShowNumber：被叫显号。 callee：被叫号码。 aRingTime：a 路响铃开始时间。格式：yyyy-MM-dd HH:mm:ss。 aEndTime：a 路响铃结束时间。格式：yyyy-MM-dd HH:mm:ss。 bRingTime：b 路响铃开始时间。格式：yyyy-MM-dd HH:mm:ss。 bEndTime：b 路响铃结束时间。格式：yyyy-MM-dd HH:mm:ss。	{"caller":"18767**","startDate":"","stateDesc":"502","duration":0,"callerShowNumber":"05344","gmtCreate":"2017-11-27 20:09:06","state":"502","endDate":"","calleeShowNumber":"053447","bRingTime":"2022-01-01 12:02:00"，"bEndTime":"2022-01-01 12:02:28"，"callee":"1373546**"}
RequestId	string	请求 ID。	A90E4451-FED7-49D2-87C8-00700A8C4D0D

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Message": "OK",
  "Data": "{\"caller\":\"18767****\",\"startDate\":\"\",\"stateDesc\":\"502\",\"duration\":0,\"callerShowNumber\":\"05344****\",\"gmtCreate\":\"2017-11-27 20:09:06\",\"state\":\"502\",\"endDate\":\"\",\"calleeShowNumber\":\"053447****\",\"bRingTime\":\"2022-01-01 12:02:00\"，\"bEndTime\":\"2022-01-01 12:02:28\"，\"callee\":\"1373546****\"}",
  "RequestId": "A90E4451-FED7-49D2-87C8-00700A8C4D0D"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史