获取用户头像下载地址

请求方法

POST

请求地址

/avatar/download-sign

请求参数

参数	参数类型	数据类型	是否必需	描述
Referer	Header	String	否	服务器地址，终端登录设置的服务器地址，带协议和端口，例如http://uc4x.yealink.com:18080
ids	Body	String[]	是	用户Id列表，最多200个
resize	Body	Resize	否	缩略图尺寸，详见Resize对象定义[]

HTTP状态码

返回值	描述
200	操作成功
400	客户端传参异常
401	鉴权失败
500	服务端异常

Resize对象定义

参数	数据类型	是否必需	描述
height	Integer	是	像素高度
width	Integer	是	像素宽度

响应参数

参数	参数类型	描述
urls	Url[]	头像下载信息列表

Url对象定义

参数	数据类型	描述
id	String	主键id，用户id
url	String	头像下载预签名地址
avatarId	String	头像id
resizeUrl	String	缩略图url

请求消息示例

POST /open/api/v2/avatar/download-sign HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
{
    "ids": [
        "1332fede469d46b09026a4baa96ef52a"
    ],
    "resize": {
        "height": 10,
        "width":  20
    }
}

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

{
    "urls": [
        {
            "id": "1332fede469d46b09026a4baa96ef52a",
            "url": "http://10.120.26.8/ydfs/api/v1/files/public/cdbcc6f134354b139360337cd970df4b.png?ydfs-file-name=1332fede469d46b09026a4baa96ef52a.png",
            "avatarId": "43155bb1208d42878754582f9afa386a",
            "resizeUrl": "http://10.120.26.8/ydfs/api/v1/files/bd228af1e2b44071885bfd4d13e5b2ea?ydfs-file-name=1332fede469d46b09026a4baa96ef52a.png&ydfs-access-key=uss&ydfs-signature-version=v2&ydfs-expires=1659425151947&ydfs-signature=PukRmbU3J%2Bhws9DJqCTgG95AgEg%2FtEqEtJTjWAjknuw%3D"
        }
    ]
}

CURL命令示例

curl -XPOST -H 'Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM
0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXorKU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp:
1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d
'{"ids":["1332fede469d46b09026a4baa96ef52a"],"resize":{"height":100,"width":100}}' 'https://api.yealink.com/open/api/v2/avatar/download-sign'