# 语音文件管理 - 上传语音文件

#### 接口说明

**用于上传语音文件到后台，用于ivr语音播放**

#### 请求方式

POST，form-data格式

#### 请求参数

| 参数名       | 类型     | 是否必须 | 说明                  |
| :-------- | :----- | :--- | :------------------ |
| service   | string | 是    | App.Sip_Voice.UploadAudio |
| token     | string | 是    | 登录token             |
| filename | file | 是    | 上传的文件         |
| voicename | string | 是    | 语音名称         |
| mark | file | 否    | 备注描述         |

#### 接口请求示例（PHP）

```
<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
    'service'    => 'App.Sip_Auth.Login',
    'token'      => 'ABCDEFG',
    'filename'  => 'ABCDEFG',
    'voicename'  => '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);
?>

```

#### 返回数据结构示例

```
{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "upload success",
        "result": {
            "id": 1897,
            "filename": "welcome.mp3",
            "voicename": "欢迎语音",
            "mark": null
        },
        "reqtime": 1788924778,
        "rsptime": 1788924779
    },
    "msg": ""
}

```

#### 返回参数说明

| 参数名         | 类型     | 说明               |
| :---------- | :----- | :--------------- |
| id | int    | 语音文件id             |
| filename | string | 语音文件             |
| voicename       | string | 语音文件名称 |