调用接口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"
}

错误码

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