Download a Recording File

Download a specific call recording file.

Steps to download a call recording file

  1. Get the download URL of a call recording file by ID or file name
  2. Download the call recording file

Request URL

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

Request parameters

Parameter Required Type Description
id No Integer The unique ID of the call recording.
Note: You can query the recording's ID using Query Recording List.
file No String The name of the call recording file.

Response parameters

Table 1.
Parameter Type Description
errcode Integer Returned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsg String Returned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
file String The name of the call recording file.
download_resource_url String The download URL of the call recording file.
Note: The download URL is only valid for 30 minutes.

Examples

Request Example

Get the download URL of a call recording file by ID.

GET /openapi/v1.0/recording/download?id=1727&access_token=WQMR0cuirhX264oZMa9pV03T9li924NS HTTP/1.1
192.168.5.150:8088

Response Example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "20220412173331-1649756009.12-2002-2005-Internal.wav",
    "download_resource_url": "/api/download/Recording-X.7.0.6-1-download-20220412175901-M8zB66xYUNTNMr2D.wav"
}

Download the call recording file

After you get the download URL of the call recording file, you need to combine the download URL with the {base_url} to compose a download request, and then send the request to download the call recording file.

Download link format

GET {base_url}/{download_resource_url}?access_token={access_token}

Download link example

GET https://192.168.5.150:8088/api/download/Recording-X.7.0.6-1-download-20220412175901-M8zB66xYUNTNMr2D.wav?access_token=WQMR0cuirhX264oZMa9pV03T9li924NS HTTP/1.1