搜索特定录音

从录音列表中搜索特定录音。

请求 URL

GET {base_url}/{api_path}/recording/search?access_token={access_token}

请求参数

参数 是否必填 类型 说明
page 否 Integer 定义显示第几个页面。
page_size 否 Integer 定义每页显示几项查询结果。
sort_by 否 String 定义排序字段。

取值范围：

  • id
  • time
order_by 否 String 定义显示顺序。

取值范围：

  • asc：升序
  • desc：降序
start_time 否 String 用于筛选通话记录的起始时间，需使用以秒为单位的 Unix 时间戳传递。
end_time 否 String 用于筛选通话记录的结束时间，需使用以秒为单位的 Unix 时间戳传递。
caller 否 String 主叫号码。
callee 否 String 被叫号码。
ids 否 String 通话录音的唯一 ID。
注：
  • 可使用 查询录音列表 接口查询通话录音 ID。
  • 使用半角逗号 , 分隔多个 ID。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的录音数量。
data Array<Recording_Details> 录音详情。
Recording_Details
参数 类型 说明
id Integer 通话录音的唯一 ID。
time String 接听或拨打该通通话的时间。
uid String 进行录音的通话的 CDR 唯一 ID。
call_from String 主叫的号码和名称。
call_to String 被叫的号码和名称。
duration Integer 呼叫时长。
size Integer 通话录音文件大小 。

单位：字节(byte)
call_type String 通讯类型。
  • Inbound：呼入
  • Outbound：呼出
  • Internal：内部
file String 通话录音文件名。
call_from_number String 主叫号码。
call_from_name String 主叫名称。
call_to_number String 被叫号码。
call_to_name String 被叫名称。

示例

请求示例

GET /openapi/v1.0/recording/search?page=1&access_token=loWZOGLcplJJjNIEeKgMWuQyKK4AkWaS&page_size=20&sort_by=id&order_by=desc&ids=449,506 HTTP/1.1 
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 2,
    "data": [
        {
            "id": 506,
            "time": "2025/08/22 10:43:31 AM",
            "uid": "202508221043319FE24",
            "call_from": "Rachel Morgan<5006>",
            "call_to": "Leo Ball<5000>",
            "duration": 17,
            "size": 568628,
            "call_type": "Internal",
            "file": "20250822104334-1755830611.29-5006-5000-Internal.wav",
            "call_from_number": "",
            "call_from_name": "",
            "call_to_number": "",
            "call_to_name": ""
        },
        {
            "id": 449,
            "time": "2025/08/13 01:54:00 PM",
            "uid": "20250813135400D8CCE",
            "call_from": "Dave Miller<5003>",
            "call_to": "Sarah Bennet<5002>",
            "duration": 1,
            "size": 31348,
            "call_type": "Internal",
            "file": "20250813135615-1755064440.60-5003-5002-Internal.wav",
            "call_from_number": "",
            "call_from_name": "",
            "call_to_number": "",
            "call_to_name": ""
        }
    ]
}