上传分机语音信箱问候语

为指定分机上传语音信箱问候语。

请求 URL

POST {base_url}/{api_path}/extension_vm_greeting/upload?access_token={access_token}

请求参数

参数 是否必填 类型 说明
owner 是 String

要上传的语音信箱问候语所属的分机的号码。

注： 可使用 搜索特定分机 接口查询分机号码。
file 是 File 语音信箱问候语文件。
注： 仅支持 “.wav”、“.mp3” 或 “.gsm” 格式的文件，且文件大小不能超过 8MB。
is_check 是 String 操作模式。

取值范围：

  • ask：检查语音信箱问候语的文件名是否已存在。
  • force：上传语音信箱问候语文件。
    注： 如果不存在重复的文件名，直接添加语音信箱问候语；否则，覆盖已有文件。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
owner String

要上传的语音信箱问候语所属的分机的号码。

示例

请求示例

  • 检查指定分机 (号码：3200) 的语音信箱问候语列表中是否已存在问候语 (文件：vm_away.wav) 的文件名。
    POST /openapi/v1.0/extension_vm_greeting/upload?access_token=L3LDr0HRuT190YmccVIaXj6OxkLzUHfo HTTP/1.1  

Host: yeastardocs.example.yeastarcloud.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="/D:/greeting/vm_away.wav"
Content-Type: audio/wav

(binary data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="owner"

3200
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="is_check"

ask
------WebKitFormBoundary7MA4YWxkTrZu0gW--
    图 1. Postman请求示例 1
  • 为指定分机 (号码：3200) 上传语音信箱问候语 (文件：vm_away.wav)。
    POST /openapi/v1.0/extension_vm_greeting/upload?access_token=L3LDr0HRuT190YmccVIaXj6OxkLzUHfo HTTP/1.1  

Host: yeastardocs.example.yeastarcloud.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="/D:/greeting/vm_away.wav"
Content-Type: audio/wav

(binary data)
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="owner"

3200
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="is_check"

force
------WebKitFormBoundary7MA4YWxkTrZu0gW--
    图 2. Postman请求示例 2

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "owner": "3200"
}