# 修改头像

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

示例示意图: 头像示意图

注意:

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

# 请求地址

HTTPS调用

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

云调用

basicInfo.modifyHeadImage

# 请求参数说明

参数 类型 必填 说明
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 本月头像修改次数已用完
其他错误码 请查看全局错误码