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

获取小程序版本列表信息

返回的结果列表中一共会展示三种状态的小程序代码版本信息,包括测试版本、审核版本、线上版本。

请求地址

GET   https://open.microapp.bytedance.com/openapi/v1/microapp/package/versions

 

Query 参数

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

 

返回值

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

data 说明:

通用返回值

参数名参数类型备注
categoriesArray<string>服务类目中文形式
ctimeint该版本的创建时间
developer_avatarstring小程序拥有者的头像
developer_idstring小程序拥有者的昵称
developer_namestring可忽略
summarystring该版本的更新信息
versionstring该版本的版本号

审核版本返回值

参数名参数类型备注
approvedAppsArray<string>申请的宿主端中,有哪些宿主端通过审核
attachInfoobject审核不通过时的附件信息
has_publishint是否已发布,0:否,1:是
is_illegal_versionbool当前审核版本是否是被下架时的那个版本,如果是则不能发布
reasonstring审核不通过原因
reasonDetailobject格式化后的审核不通过原因
statusint当前审核状态,0:审核中,1:通过,2:不通过,3:撤回审核

线上版本返回值

参数名参数类型备注
approvedAppsArray<string>申请的宿主端中,有哪些宿主端通过审核
attachInfoobject审核不通过时的附件信息
has_downint是否下架,0:否,1:是
notApprovedAppsArray<string>申请的宿主端中,有哪些宿主端没有通过审核
reasonstring审核不通过原因
reasonDetailobject格式化的审核不通过原因
rollbackobject回退信息
can_rollbackbool能否回退
last_versionstring如果可以回退,可以回退到的上一版本号
uidint可忽略

测试版本返回值

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

返回值示例

{
  "errno": 0,
  "message": "success",
  "data": {
    "audit": {
      "approvedApps": ["抖音"],
      "attachInfo": {
        "今日头条": "http://xxxx",
        "今日头条极速版": "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": false,
      "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"
    }
  }
}

注意:

  • latest: 指测试版本
  • audit: 指审核版本
  • current: 指线上版本
点击纠错
评价此篇文档