第三方平台
第三方平台概述
创建第三方平台
常见问题排查指南

修改小程序图标

为授权小程序修改图标

请求地址

POST   https://open.microapp.bytedance.com/openapi/v1/microapp/app/modify_app_icon

 

Query 参数

参数名参数类型是否必须备注
component_appidstring第三方平台的 appid
authorizer_access_tokenstring授权小程序的接口调用令牌

Body 参数(json)

参数名参数类型是否必须备注
new_icon_pathstring授权小程序准备修改的图标路径
注意:需要使用 上传图片材料 接口返回的路径才可以,否则报错。

Body 参数示例

{
  "new_icon_path": "thirdparty/${tpAppId}/${prefix}/${hash}"
}

 

返回值

参数名参数类型备注
errnoint错误码
messagestring错误信息

返回值示例

{
  "errno": 0,
  "message": "success"
}

错误码

参数名参数类型
21100修改图标失败,请稍后再试
21101小程序图标路径错误,不能正常获取图标文件
21102当前小程序图标修改正在审核
40033获取不到上传的图片材料,请确认文件路径正确

 

修改图标审核结果通知

修改图标审核结果出来之后,会自动触发消息发送,然后第三方应用会收到由第三方服务器推送的相应授权小程序的修改图标的审核结果。

POST 数据示例:

{
  "Nonce": "4464221",
  "TimeStamp": "1535551395",
  "Encrypt": "Encrypt Message xxxxxxxx",
  "MsgSignature": "ba394c04acece6c2c0edee058c5dddf82474b8ee"
}

其中 Encrypt 参数需要解密,解密详情见第三方平台消息加密解密部分:

{
  "AppId": 授权小程序的appid,
  "TpAppId": 第三方平台appid,
  "EventTime": "2019-01-14 12:45:10",
  "Event": "MODIFY_APP_ICON",
  "ModifyAppIconResults": {
    "reason": "小程序名称格式不符合规范",
    "status": 0
  }
}

消息体字段含义如下:

参数名参数类型备注
AppIdstring授权小程序的 appid
TpAppIdstring第三方平台的 appid
EventTimestring推送事件时间
Eventstring推送事件类型
ModifyAppIconResultsobject修改图标的审核结果
reasonstring如果被拒,被拒原因
statusint0 或 1,0 代表不通过,1 代表通过
点击纠错
评价此篇文档