调用FindAppVersions分页获取应用版本列表。

支持多种查询条件,如机型、系统版本号等。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String FindAppVersions

系统规定参数。取值:FindAppVersions

ProjectId String P0VFCREU

项目ID

PageIndex Integer 1

分页索引,从1开始。

PageSize Integer 20

每页大小,支持20,50。

RegionId String cn-shanghai

地域ID

VersionId String 12345

版本ID

AppId String 123

应用ID

DeviceModelId String 1230

设备型号ID

Status String PUBLISHED

版本状态,如TESTINGTEST_PASSEDPREPUBLISHPUBLISHED

Remark String sample remark

备注

返回数据

名称 类型 示例值 描述
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

AppVersionList

版本列表信息,包括当前页的版本列表以及总共符合条件的版本个数。

Items

符合条件的当前页的版本列表。

AppId String 20

应用ID

AppName String iovcc-ota

应用名

AppPackageName String com.aliyun.iovcc.ota

应用包名

AppVersion String 2.0.2

应用版本号

GmtCreate String 2018-04-24 12:23:45

版本创建时间

GmtCreateTimestamp Long 12432500000

版本创建时间戳

GmtModify String 2018-04-24 12:23:45

版本更新时间

GmtModifyTimestamp Long 12432500000

版本更新时间戳

Id Long 12345

版本ID

InstallType String auto

版本升级包客户端安装类型。取值:

  • auto:表示自动安装
  • customize:表示自定义安装
IsAllowNewInstall String Y

表示当客户端不存在此应用时,是否允许新安装此应用,相当于后装。

IsForceUpgrade String N

是否强制升级,Y或N

IsNeedRestart String N

是否需要重启,Y或N

IsSilentUpgrade String N

是否静默升级,Y或N

RestartAppParam String N

应用重启参数,Y或N

RestartAppType String service

如果restartType为应用重启,则这个字段表示应用重启的类型。取值:

  • service:表示Service重启
  • activity:表示Activity重启
RestartType String app

应用安装完成后的重启类型,取值:

  • system:表示系统重启
  • app:表示应用重启
Status String PUBLISHED

版本状态,状态定义和系统版本升级一致。

StatusName String 已发布

状态名

VersionCode String 201

应用版本versioncode,是用于应用升级版本比较大小的字段。

TotalCount Integer 1000

符合条件的总记录数,方便调用方计算总页数。

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=FindAppVersions
&ProjectId=P0VFCREU
&PageIndex=1
&PageSize=20
&<公共请求参数>

正常返回示例

XML 格式

<FindAppVersionsResponse>
	  <AppVersionList>
		    <Items>
			      <AppId>1</AppId>
			      <AppName>iovcc-ota</AppName>
			      <AppPackageName>com.aliyun.iovcc.ota</AppPackageName>
			      <AppVersion>2.0.2</AppVersion>
			      <AsAllowNewInstall>N</AsAllowNewInstall>
			      <GmtCreate></GmtCreate>
			      <GmtModify></GmtModify>
			      <Id>124</Id>
			      <InstallType>auto</InstallType>
			      <IsForceUpgrade>N</IsForceUpgrade>
			      <IsNeedRestart>N</IsNeedRestart>
			      <IsSilentUpgrade>N</IsSilentUpgrade>
			      <RestartAppParam>N</RestartAppParam>
			      <RestartAppType>N</RestartAppType>
			      <RestartType>system</RestartType>
			      <Status>PUBLISHED</Status>
			      <StatusName>已发布</StatusName>
			      <VersionCode>202</VersionCode>
		    </Items>
		    <TotalCount>1000</TotalCount>
	  </AppVersionList>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</FindAppVersionsResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"AppVersionList":{
		"Items":[
			{
				"RestartType":"system",
				"AsAllowNewInstall":"N",
				"AppVersion":"2.0.2",
				"IsForceUpgrade":"N",
				"AppId":"1",
				"InstallType":"auto",
				"IsSilentUpgrade":"N",
				"GmtCreate":"",
				"Status":"PUBLISHED",
				"RestartAppType":"N",
				"IsNeedRestart":"N",
				"VersionCode":202,
				"RestartAppParam":"N",
				"StatusName":"已发布",
				"AppName":"iovcc-ota",
				"Id":124,
				"AppPackageName":"com.aliyun.iovcc.ota",
				"GmtModify":""
			}
		],
		"TotalCount":1000
	}
}

错误码

访问错误中心查看更多错误码。