设置个人头像

通过图片 URL 更换当前微信实例的个人头像。

接口地址： POST /sendHeadImage

前置条件

• 微信实例已登录，并已获得可用的 wId。
• path 必须是微信客户端可访问的图片 URL。
• 设置成功后需返回微信首页并重启，手机端才会展示最新头像。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
path	是	string	头像图片 URL

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	null	成功或失败时通常为空

请求示例

{
  "wId": "01377f33-544c-4dc4-9184-bcbbcd3b05d0",
  "path": "https://cdn.e-yun.example/avatar/customer-service.jpg"
}

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": null
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 建议使用 HTTPS 图片地址，避免图片无法被客户端加载。
• 头像属于真实微信账号资料，业务系统应限制操作权限并记录操作人。