获取小程序版本列表信息v2

收藏
我的收藏

接口说明

该接口可以获取对应授权小程序的版本列表,包含测试版本,审核版本,灰度版本,线上版本的具体信息(注意,使用此接口,需要使用v2版本的access-token)

基本信息

名称描述
HTTP URL
https://open.douyin.com/api/apps/v1/package_version/versions/
HTTP Method
GET
Scope
ma.package.version
权限要求
需要授权小程序授予对应的开发管理权限

请求参数

请求头
access-token必填String
示例:isvact.0801121846735352506a356a6
content-type必填String
示例:application/json
固定值"application/json"
请求示例
curl --location --request GET 'https://open.douyin.com/api/apps/v1/package_version/versions/' \ --header 'content-type: application/json' \ --header 'access-token: isvact.0801121846735352506a356a6' \

响应参数

Body展开全部子属性
err_msg必填String
错误信息
err_no必填Int32
错误码
log_id必填String
调用的链路唯一标识,可使用此log_id找内部人员反应问题
dataStruct
示例:{}
版本信息响应体
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "success", "log_id": "2034EAC", "data": { "audit": { "approved_apps": [ "抖音" ], "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: 无法进入小程序", "reason_detail": { "今日头条": [ "无法进入小程序", "小程序页面存在闪退、卡顿、黑屏等功能异常问题" ], "今日头条lite": [ "无法进入小程序" ] }, "status": 2, "summary": "今天是5月30日", "version": "1.0.1" }, "current": { "approved_apps": [], "attachInfo": {}, "categories": [ "服务类-快递、物流-查件" ], "ctime": 1585727678, "developer_avatar": null, "developer_id": null, "developer_name": null, "has_down": 0, "not_approved_apps": [], "reason": "", "reason_detail": {}, "rollback": { "can_rollback": false, "last_version": "" }, "summary": "测试版本1.0.0", "uid": 123232323234324, "version": "1.0.0" }, "latest": { "categories": [ "服务类-快递、物流-查件" ], "ctime": 1590755478, "developer_avatar": "xxx", "developer_id": "xxx", "developer_name": "xxx", "has_audit": 1, "screenshot": "", "summary": "今天是5月30日", "version": "1.0.1" }, "gray": { "categories": [ "服务类-快递、物流-查件" ], "ctime": 1590755478, "developer_avatar": "xxx", "developer_id": "xxx", "developer_name": "xxx", "has_audit": 1, "screenshot": "", "summary": "今天是5月30日", "version": "1.0.1", "host_gray_scale": {} } } }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
20040001
参数错误
检查access-token等信息是否正确
20040003
找不到相关第三方小程序应用
检查access-token等信息是否正确,检查第三方应用是否被删除
20040004
找不到相关授权小程序
检查access-token等信息是否正确,检查授权小程序是否被删除
20028001008
access_token过期,请刷新或重新授权
按错误码描述进行操作
20028001018
授权小程序未授予第三方应用的对应调用权限
先确认调用场景是否符合内部业务诉求,如符合,请联系授权小程序管理人员重新授权