接口介绍

该接口用于第三方小程序应用为授权小程序获取小程序版本列表信息。

请求

基本信息

基本
HTTP URL	https://open.microapp.bytedance.com/openapi/v1/microapp/package/versions
HTTP Method	GET
权限要求	授权小程序授予开发管理权限

查询参数

参数名	参数类型	是否必须	备注
component_appid	string	是	第三方小程序应用 appid
authorizer_access_token	string	是	授权小程序接口调用凭据

响应

响应体

参数名	参数类型	备注
errno	int	错误码
message	string	错误信息
data	object

data 说明：

版本对应关系

名称	参数类型	备注
latest	object	测试版本
audit	object	审核版本
current	object	线上版本

版本信息通用返回值

参数名	参数类型	备注
categories	Array<string>	服务类目中文形式
ctime	int	该版本的创建时间
developer_avatar	string	小程序拥有者的头像
developer_id	string	小程序拥有者的 ID
developer_name	string	小程序拥有者的昵称
summary	string	该版本的更新信息
version	string	该版本的版本号

测试版本返回值

参数名	参数类型	备注
has_audit	int	是否已提审，0:否，1:是
screenshot	string	上传代码包时的三张截图路径，英文分号分隔

审核版本返回值

参数名	参数类型	备注
approvedApps	Array<string>	申请的宿主端中，有哪些宿主端通过审核
attachInfo	object	审核不通过时的附件信息
has_publish	int	是否已发布，0:否，1:是
is_illegal_version	bool	当前审核版本是否是被下架时的那个版本，如果是则不能发布
reason	string	审核不通过原因
reasonDetail	object	格式化后的审核不通过原因
status	int	当前审核状态，0:审核中，1:通过，2:不通过，3：撤回审核

线上版本返回值

参数名	参数类型	备注
approvedApps	Array<string>	申请的宿主端中，有哪些宿主端通过审核
attachInfo	object	审核不通过时的附件信息
has_down	int	是否下架，0:否，1:是
notApprovedApps	Array<string>	申请的宿主端中，有哪些宿主端没有通过审核
reason	string	审核不通过原因
reasonDetail	object	格式化的审核不通过原因
rollback	object	回退信息
uid	int	开发者平台账号 id

回退信息

参数名	参数类型	备注
can_rollback	bool	能否回退
last_version	string	如果可以回退，可以回退到的上一版本号

响应体示例

{
  "errno": 0,
  "message": "success",
  "data": {
    "audit": {
      "approvedApps": ["抖音"],
      "attachInfo": {
        "今日头条": "http://xxxx",
        "今日头条lite": "http://xxxx"
      },
      "categories": ["服务类-快递、物流-查件"],
      "ctime": 1591019952,
      "developer_avatar": "xxx",
      "developer_id": "xxx",
      "developer_name": "xxx",
      "has_publish": 0,
      "is_illegal_version": false,
      "reason": "今日头条: 无法进入小程序;小程序页面存在闪退、卡顿、黑屏等功能异常问题;今日头条lite: 无法进入小程序",
      "reasonDetail": {
        "今日头条": ["无法进入小程序", "小程序页面存在闪退、卡顿、黑屏等功能异常问题"],
        "今日头条lite": ["无法进入小程序"]
      },
      "status": 2,
      "summary": "今天是5月30日",
      "version": "1.0.1"
    },
    "current": {
      "approvedApps": [],
      "attachInfo": {},
      "categories": ["xxx-xxx-xxx"],
      "ctime": 1585727678,
      "developer_avatar": null,
      "developer_id": null,
      "developer_name": null,
      "has_down": 0,
      "notApprovedApps": [],
      "reason": "",
      "reasonDetail": {},
      "rollback": {
        "can_rollback": false,
        "last_version": ""
      },
      "summary": "测试版本1.0.0",
      "uid": xxx,
      "version": "1.0.0"
    },
    "latest": {
      "categories": ["xxx-xxx-xxx"],
      "ctime": 1590755478,
      "developer_avatar": "xxx",
      "developer_id": "xxx",
      "developer_name": "xxx",
      "has_audit": 1,
      "screenshot": "",
      "summary": "今天是5月30日",
      "version": "1.0.1"
    }
  }
}

注意：

• 接口会返回测试版本、审核版本、线上版本三种版本信息。没有该版本时，对应的字段为 null。

错误码

错误码	message
40001	参数错误
40003	找不到相关第三方小程序应用
40004	找不到相关授权小程序
40020	第三方小程序应用 authorizer_access_token 不正确或者已过期
40036	授权小程序未授予该接口对应的权限