获取小程序版本列表信息

我的收藏

接口介绍

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

请求

基本信息

基本
`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	授权小程序未授予该接口对应的权限

下一篇：服务商平台概述