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

说明
  • QueryCallDetailByCallId接口为通用查询接口，可查询语音通知、语音验证码、语音IVR、语音双呼、智能语音交互呼入、智能语音交互呼出、智能外呼机器人呼叫记录。
  • QueryCallDetailByCallId的调用频率限制为100次/分钟之内。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 QueryCallDetailByCallId

系统规定参数。取值：QueryCallDetailByCallId。

CallId String 是 116014888060^10281631****

通话的唯一识别ID。

说明
  • 调用其他外呼接口发起通话后，返回参数中会携带CallId。
  • CallId与QueryDate必须是同一天。
  • CallId必须与产品ProdId相匹配。
ProdId Long 是 11000000300006

产品ID。取值：

  • 11000000300006：语音通知。
  • 11010000138001：语音验证码。
  • 11000000300005：语音IVR。
  • 11000000300004：语音双呼。
  • 11000000300009：语音SIP。
  • 11030000180001：智能外呼。
QueryDate Long 是 1553774465000

指定通话发生的时间。格式为Unix时间戳，单位：毫秒。

会查询这个时间点对应的一整天的记录。

返回数据

名称 类型 示例值 描述
Code String OK

请求状态码。

  • 返回OK代表请求成功。
  • 其他错误码，请参见错误码列表。
Data String {\"callId\":\"122037727021^10883151****\",\"duration\":3,\"calleeShowNumber\":\"0571999****\",\"endDate\":\"2021-03-03 10:40:05\",\"stateDesc\":\"用户接听\",\"callee\":\"1862903****\",\"state\":\"200000\",\"gmtCreate\":\"2021-03-03 10:39:46\",\"startDate\":\"2021-03-03 10:40:03\",\"hangupDirection\":0}

呼叫详情。JSON格式。

  • caller：主叫号码。
  • startDate：通话开始时间。
  • stateDesc：通话状态描述。
  • duration：通话时长。单位：秒。0：用户未接通。
  • calleeShowNumber：主叫显号。
  • gmtCreate：通话请求的接收时间。
  • state：通话状态。通话状态是运营商实时返回的，更多状态信息，请参见运营商回执错误码。
  • endDate：通话结束时间。
  • calleeShowNumber：被叫显号。
  • callee：被叫号码。
Message String OK

状态码的描述。
RequestId String A90E4451-FED7-49D2-87C8-00700A8C4D0D

请求ID。

示例

请求示例

http(s)://dyvmsapi.aliyuncs.com/?Action=QueryCallDetailByCallId
&CallId=116014888060^10281631****
&ProdId=11000000300006
&QueryDate=1553774465000
&<公共请求参数>

正常返回示例

XML格式 

<QueryCallDetailByCallIdResponse>
  <Message>OK</Message>
  <RequestId>8AE16BCD-3B80-4571-87CF-B5AB63C8B652</RequestId>
  <Data>{"callId":"122037727021^10883151****","duration":3,"calleeShowNumber":"0571999****","endDate":"2021-03-03 10:40:05","stateDesc":"用户接听","callee":"1862903****","state":"200000","gmtCreate":"2021-03-03 10:39:46","startDate":"2021-03-03 10:40:03","hangupDirection":0}</Data>
  <Code>OK</Code>
</QueryCallDetailByCallIdResponse>

JSON格式 

{
	"Message": "OK",
	"RequestId": "8AE16BCD-3B80-4571-87CF-B5AB63C8B652",
	"Data": "{\"callId\":\"122037727021^10883151****\",\"duration\":3,\"calleeShowNumber\":\"0571999****\",\"endDate\":\"2021-03-03 10:40:05\",\"stateDesc\":\"用户接听\",\"callee\":\"1862903****\",\"state\":\"200000\",\"gmtCreate\":\"2021-03-03 10:39:46\",\"startDate\":\"2021-03-03 10:40:03\",\"hangupDirection\":0}",
	"Code": "OK"
}

错误码

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