上传群语音信箱问候语

上传群语音信箱问候语。

请求 URL

POST {base_url}/{api_path}/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

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

示例

请求示例

  • 检查指定群语音信箱 (号码：6300) 的问候语列表中是否已存在问候语 (文件：group_vm_welome2.wav) 的文件名。
    POST /openapi/v1.0/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/group_vm_welome2.wav"
Content-Type: audio/wav

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

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

ask
------WebKitFormBoundary7MA4YWxkTrZu0gW--
    图 1. Postman 请求示例 1
  • 为指定群语音信箱 (号码：6300) 上传问候语 (文件：group_vm_welome2.wav)。
    POST /openapi/v1.0/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/group_vm_welome2.wav"
Content-Type: audio/wav

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

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

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

响应示例

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