根据通话id查询通话详情
注意:收到话单回调消息后再来查询,否则可能查询不到
请求地址:https://cloud-vms.volcengineapi.com
请求方式:POST
参数 | 数据类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
X-Date | String | 是 | 20201103T104027Z | 鉴权字段。请参考文档中心-火山引擎。 |
Authorization | String | 是 | HMAC-SHA256 Credential*** | 鉴权字段。请参考文档中心-火山引擎。 |
ServiceName | String | 是 | vms | 服务名称。该接口是vms 。 |
Region | String | 是 | cn-north-1 | 区域名称,固定值cn-north-1 。 |
Content-Type | String | 是 | application/x-www-form-urlencoded |
参数 | 参数类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | QueryCallRecordMsg | 接口名称。该接口固定值为QueryCallRecordMsg |
Version | String | 是 | 2022-01-01 | 接口版本。接口版本为2022-01-01 ,注意与旧版服务不同 |
参数 | 参数类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
CallIdList | String | 是 | NM12345,Dcc12345 | 通话id列表,以英文逗号间隔。 |
curl --location --request POST 'https://cloud-vms.volcengineapi.com?Action=QueryCallRecordMsg&Version=2022-01-01' \ --header 'ServiceName: vms' \ --header 'Region: cn-north-1' \ --header 'X-Date: 20201103T104027Z' \ --header 'Authorization: HMAC-SHA256 Credential=***' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'CallIdList=NM12345,Dcc12345'
参数 | 数据类型 | 描述 |
---|---|---|
ResponseMetadata | ResponseMetadata | 响应公共参数。 |
Result | Result | 响应业务参数。 |
参数 | 数据类型 | 描述 |
---|---|---|
RequestId | string | 请求 ID。 |
Action | string | 请求的接口名称。 |
Version | string | 请求的版本号。 |
Service | string | 请求的服务名称。 |
Region | string | 请求的区域。 |
Error | Error | 错误信息。如果请求没有异常则不会返回错误信息。包含的参数说明请参见错误码部分。 |
参数 | 数据类型 | 描述 |
---|---|---|
话单数组 | Array | 话单,根据不同子服务类型返回不同字段,参考呼叫记录 |
备注:新版接口与旧版接口的区别在于时间字段使用了不同的序列化方式,新版使用unix时间戳(毫秒),旧版使用ISO8601格式(yyyy-MM-dd'T'HH:mm:ss.SSSZ)
参数 | 数据类型 | 描述 |
---|---|---|
Code | string | 错误码。 |
Message | string | 错误信息。 |
火山引擎网关的公共错误码,请参见火山引擎网关公共错误码。
Code | Message | 说明 | 处理建议 |
---|---|---|---|
RequestParametersError | Unexpected Parameters | 参数异常 | 检查请求通话id数量是否超过100 |
SystemError | The system meets an error while executing your request, contact us please | 服务异常,可能是遇到了网络抖动 | 可重试请求 |
{ "ResponseMetadata": { "RequestId": "2021011918400501022510703413004E18", "Action": "QueryCallRecordMsg", "Version": "2022-01-01", "Service": "vms", "Region": "cn-north-1" }, "Result": [ { "callId": "NM12345", "callerCityCode": "025", "serviceType": 100, "callDuration": 3, "calleeProvinceCode": "310000", "ringTime": 1657536036000, "userData": "", "numberPoolNo": "NP123", "callee": "13688888888", "callerProvinceCode": "320000", "calleeCountryIsoCode": "CN", "beginCallTime": 1657536036000, "callType": 1, "accountId": "2000000001", "caller": "13888888888", "subServiceType": 101, "releaseType": 0, "startTime": 1657536036000, "callerCountryIsoCode": "CN", "endTime": 1657536039000, "callResult": 1, "audioRecordFlag": 1, "calleeCityCode": "021", "outId":"2342434654" } ] }