接口说明 / App 换头像接口

App 换头像接口对接说明

• 更新日期：2026-10-20
• 图片上传服务：https://img.menkou.com

说明

换头像分两步：先上传图片获取 URL，再调用设置头像接口。设置接口需要登录态。

接口地址

图片上传 Base：https://img.menkou.com

设置头像 Base：https://api.menling.com

鉴权：设置头像时携带登录态 Cookie。

流程（两步）

1）上传图片

• POST https://img.menkou.com/api/upload（multipart，字段名 file）
• 接口仅接受 POST；需携带平台分配的鉴权信息，未授权返回 401。
• 成功后返回图片访问地址，形如 https://img.menkou.com/.../xxx.png（以接口实际返回为准）。

2）设置头像

• POST https://api.menling.com/user/set_portrait_uri
• Header：Content-Type: application/json + 登录态
• Body：

{"portraitUri":"https://img.menkou.com/.../xxx.png"}

成功返回 {"code":200}。

接入注意

1. 图片上传必须使用 https://img.menkou.com。
2. 先 POST /api/upload 再 set_portrait_uri，portraitUri 使用上传返回的图片地址。
3. 上传与设置头像均需鉴权；未授权请求会被拒绝。
4. 上传与设置成功后，客户端刷新本地资料即可。