获取企业内部小程序的版本列表

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口获取企业内部小程序的版本列表。

接口功能介绍

调用本接口，可以通过开发者后台 > 企业内部应用 > 小程序 > 应用详情 > 版本管理与发布页，获取当前小程序开发版本、体验版本和线上版本信息列表，包括小程序的版本号、版本的发布创建时间等相关信息。具体如下图：

说明

只有企业内部小程序才能调用该接口获取数据。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	查询企业的微应用列表权限	API Explorer
第三方企业应用	暂不支持	查询企业的微应用列表权限	暂不支持
第三方个人应用	暂不支持	查询企业的微应用列表权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParam	参数错误: %s	参数错误
400	invalidAgentId	不合法的agentId	不合法的agentId
400	noAppManagePermission	没有操作应用的权限	没有操作应用的权限
400	appTypeNotSupport	只支持企业自建小程序调用	只支持企业自建小程序调用
400	preCheckError	前置校验失败: %s	前置校验失败
500	systemBusy	系统繁忙	系统繁忙

{ "appVersionList": [ { "appVersionId": 0, "miniAppId": "string", "appVersion": "string", "appVersionType": 0, "miniAppOnPc": true, "createTime": "string", "modifyTime": "string", "entranceLink": "string" } ] }

请求参数

Path 参数

agentId

string

必需

应用AgentId。

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

返回响应

🟢200成功

application/json

Body

appVersionList

array [object {8}]

必需

企业内部小程序版本号列表。

appVersionId

integer

可选

小程序版本id，用于发布和回滚小程序版本唯一标识。

miniAppId

string

小程序id。

可选

appVersion

string

小程序版本号。

可选

appVersionType

integer

可选

小程序版本类型，取值： 0：开发版本 2：正式版本 3：体验版本

miniAppOnPc

boolean

可选

是否支持PC端打开小程序，取值： false：只支持移动端 true：既支持移动端又支持PC端

createTime

string

可选

小程序版本创建时间，格式:yyyy-MM-dd HH:mm:ss。

modifyTime

string

可选

小程序版本号更新时间，格式:yyyy-MM-dd HH:mm:ss。

entranceLink

string

可选

企业内部小程序版本的跳转链接。说明目前只会返回体验版小程序的跳转链接。

获取企业内部小程序的版本列表

接口功能介绍#

权限#

错误码#

请求参数

返回响应

接口功能介绍

权限

错误码