调用FindVersionWhiteDevices分页获取系统版本或应用版本的设备白名单。

调试

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

请求参数

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

系统规定参数。取值:FindVersionWhiteDevices

PageIndex Integer 1

分页索引,从1开始。

PageSize Integer 20

分页大小,支持10、20、50三种。

ProjectId String P0VFCREU

项目ID

RegionId String cn-shanghai

地域ID

VersionId String 12345

版本ID

VersionType String FOTA

版本类型。支持:

  • FOTA:系统升级
  • APP:应用升级
DeviceId String AS23DG23SA5D43GA34SD23GW456E

设备ID,支持模糊匹配。

OriginalId String 23452345234523452

源设备ID,支持模糊匹配。

返回数据

名称 类型 示例值 描述
DeviceList

设备列表信息

Items

当前分页的设备数据

DeviceId String AS23DG23SA5D43GA34SD23GW456E

设备ID

GmtCreate String 2018-02-14 14:20:18

添加时间

GmtCreateTimestamp Long 1868400000

创建时间戳

Id Long 123

白名单ID

IdType String hardware_id

设备ID类型,支持:

  • device_id:硬件ID
  • sn:序列号
  • vin:车架号
  • hardware_id:硬件ID
OriginalId String 23452345234523452

源设备ID

TotalCount Integer 30

总共符合条件的设备数

RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

示例

请求示例


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

正常返回示例

XML 格式

<FindVersionWhiteDevicesResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <DeviceList>
		    <TotalCount>25</TotalCount>
		    <Items>
			      <Id>1</Id>
			      <DeviceId>AS23DG23SA5D43GA34SD23GW456E</DeviceId>
			      <IdType>hardware_id</IdType>
			      <OriginalId>23452345234523452</OriginalId>
			      <GmtCreate>2018-02-14 14:20:18</GmtCreate>
		    </Items>
	  </DeviceList>
</FindVersionWhiteDevicesResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"DeviceList":{
		"Items":[
			{
				"DeviceId":"AS23DG23SA5D43GA34SD23GW456E",
				"IdType":"hardware_id",
				"OriginalId":"23452345234523452",
				"Id":1,
				"GmtCreate":"2018-02-14 14:20:18"
			}
		],
		"TotalCount":25
	}
}

错误码

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