# Common API - Call recording download link interface

#### Interface Description

Get the download link for the call log file. At present, call recordings are saved for 3 months, and it is recommended to save them locally。

#### request parameters

| parameter name      | type     | Is it necessary | illustrate                         |
| :------- | :----- | :--- | :------------------------- |
| service  | string | yes    | App.Sip_Cdr.GetRecodeFile |
| token    | string | yes   | The token obtained through the authorization interface             |
| filename | string | yes   | The recording file name returned in the call recording callback            |

#### Interface request example（PHP）

```
<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Cdr.GetRecodeFile',
        'token'     => 'ABCDEFG',
        'filename'  => 'abcdefg',
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

```

#### return data structure example

```
{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "get success",
        "result": {
            "downurl": "http://127.0.0.1:8080/abcdefg",
            "expiredtime": "Expiration time：2020-02-11 17:27:23"
        },
        "reqtime": 1581412943,
        "rsptime": 1581412943
    },
    "msg": ""
}

```

#### Return parameter description

| parameter name         | type     | illustrate         |
| :---------- | :----- | :--------- |
| result      | objest | returned result set     |
| downurl     | string | Call recording file download link |
| expiredtime | string | Download link expiration time   |