修改头像

调用本接口可以修改小程序的头像。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

示例示意图: 头像示意图

注意:

  1. 小程序头像每个月固定的修改次数上限
  2. 图片格式只支持:BMP、JPEG、JPG、GIF、PNG,大小不超过 2M
  3. 实际头像始终为正方形

请求地址

POST https://api.weixin.qq.com/cgi-bin/account/modifyheadimage?access_token=ACCESS_TOKEN

请求参数说明

参数 类型 必填 说明
access_token string 第三方平台接口调用令牌authorizer_access_token
head_img_media_id media_id 头像素材 media_id
x1 string 裁剪框左上角 x 坐标(取值范围:[0, 1])
y1 string 裁剪框左上角 y 坐标(取值范围:[0, 1])
x2 string 裁剪框右下角 x 坐标(取值范围:[0, 1])
y2 string 裁剪框右下角 y 坐标(取值范围:[0, 1])

media_id

临时素材 media_id 通过调用“临时素材管理接口”获取.调用如下接口时请使用第三方平台接口调用令牌authorizer_access_token

新增临时素材

获取临时素材

POST 数据示例:

{
  "head_img_media_id": "mI-4E_sFh_2X3g-qmTIWD83RT78ytI1_6VfgFp_A3-Y2U5T_nLl3nm1xYTafFJ8p",
  "x1": "0",
  "y1": "0",
  "x2": "0.7596899224806202",
  "y2": "0.49"
}

返回参数说明

参数 类型 说明
errcode number 返回码
errmsg string 错误信息

返回结果示例:

{
  "errcode": 0,
  "errmsg": "ok"
}

返回码说明

errcode 取值 说明
0 成功
40097 参数错误
41006 media_id 不能为空
40007 非法的 media_id
46001 media_id 不存在
47001 数据格式错误
40009 图片尺寸太大
53202 本月头像修改次数已用完
其他错误码 请查看全局错误码