QueryCallRecordMsgV2 - 查询话单消息--语音服务-火山引擎

文档中心

立即注册

语音服务

通话数据

QueryCallRecordMsgV2 - 查询话单消息

根据通话id查询通话详情

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	QueryCallRecordMsgV2	要执行的操作，取值：QueryCallRecordMsgV2。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
CallIdList	Array of String	是	NM1234	通话id列表，以英文逗号间隔。单次最大查询量为100条

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Records	Array of Object	[{ "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" }]	话单数据，根据不同子服务类型返回不同字段，参考[呼叫记录](https://www.volcengine.com/docs/6358/173366)

请求示例

POST /?Action=QueryCallRecordMsgV2&Version=2022-01-01 HTTP/1.1
Host: https://cloud-vms.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250603T124657Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250603/cn-beijing/vms/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "CallIdList": [
    "NM1234"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2025060320470220805415303437C6AA",
    "Action": "QueryCallRecordMsgV2",
    "Version": "2022-01-01",
    "Service": "vms",
    "Region": "cn-beijing"
  },
  "Result": {
    "Data": [
      {
        "callId": "NM12345",
        "callerCityCode": "zZFgAuZ",
        "serviceType": 100,
        "calleeProvinceCode": "tSin1A6Cpth",
        "ringTime": 534,
        "userData": "eVRkE9",
        "numberPoolNo": "NP123",
        "callee": "24E1D",
        "callerProvinceCode": "SHwB8AnEA",
        "beginCallTime": 512,
        "callType": 116,
        "accountId": "WloH9PVf9",
        "caller": "JKZOMFz",
        "subServiceType": 720,
        "releaseType": 639,
        "startTime": 1657536036000,
        "endTime": 1657536039000,
        "callResult": 1,
        "audioRecordFlag": 166,
        "calleeCityCode": "010",
        "outId": "OZx"
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	UnauthenticatedRequest	未登录的请求
200	RequestParametersError	Unexpected Parameters

最近更新时间：2025.07.11 17:27:25

这个页面对您有帮助吗？

有用

无用

语音服务

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码