到门口开放平台open.menkou.com

接口说明 / App 换头像接口

App 换头像接口对接说明

说明

换头像走两步:先上传拿 URL,再设置头像。鉴权与现网 IM 登录一致。

正确接口(给研究院 / App)

Base:https://api.menling.com(IM 域;不要指 api.menkou.com)

鉴权:登录 Cookie `rong_auth_cookie=<登录Cookie> IM 一致;也可带现网 JWT/Bearer 若客户端已切)。

流程(两步)

  1. 上传图片
    - POST /file/upload(multipart,字段名 file)
    - 无需登录(已在 exclude_url)
    - 成功:
    json {"code":200,"result":{"url":"https://daomenkoumedia.oss-cn-shenzhen.aliyuncs.com/menling/yyyy/MM/dd/xxx.png","height":..,"width":..,"scale":"..","extendType":"img"}}
    - 取 result.url 作为头像地址。

  2. 设置头像
    - POST /user/set_portrait_uri
    - Header:Content-Type: application/json + 登录态
    - Body:
    json {"portraitUri":"https://daomenkoumedia.oss-cn-shenzhen.aliyuncs.com/menling/.../xxx.png"}
    - 成功:
    json {"code":200}
    或首次设置:
    json {"code":200,"message":"恭喜设置成功,能量+50","result":1}

相关(可选)

App 源码对照

端 入口 上传 设置
Android MyAccountActivityNew → UserInfoViewModel.uploadPortrait FileManager.uploadImage → POST /file/upload POST user/set_portrait_uri
iOS DMKMeInfoTableViewController DMKUploadManager → file/upload DMKUserInfoAPI setCurrentUserPortrait → user/set_portrait_uri

SEALTALK_SERVER / iOS serverURL = https://api.menling.com。

服务端说明

换头像审核链路已软放行异常失败,现网烟测可通过。依赖冲突的强制审核修复另议。

App 侧注意

  1. Base 必须 api.menling.com;业务商城勿混用 api.menkou.com。
  2. 先 POST /file/upload 再 set_portrait_uri,portraitUri 用上传返回的 result.url。
  3. 需要登录态;未登录会 403。
  4. 违规等级 23(禁止改头像昵称)仍会拒绝。
  5. 去融云后以服务端资料与 App 本地刷新为准。