上传分机头像

上传图片至 PBX，作为分机头像。

注：
  • 头像文件必须为 .jpg 和 .png 格式，且文件大小不得超过 1 MB。
  • 系统会在每天凌晨 1:00 自动清理存放时间超过 1 小时的头像文件。

请求 URL

POST {base_url}/{api_path}/extension/uploadtempavatarfile?access_token={access_token}

请求参数

参数 是否必填 类型 说明
file 是 File 所需头像文件，通过 form-data 格式上传。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
file String 上传头像的文件 ID。

示例

请求示例

POST /openapi/v1.0/extension/uploadtempavatarfile?access_token=0tFkq4WxebvAU6z5UWzU2XTQJhoRefIh HTTP/1.1 

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

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="/D:/project/avatars/demo.jpg"
Content-Type: image/jpeg

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--
图 1. Postman 请求示例

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "FMwAglNeey743Vcq63fd393d-847f-4b2e-af9d-7eadc23557d2"
}