调用FindVersionMessages查询某一版本、测试或群发记录下的消息发送情况。
说明 根据MessageType决定查询的目标类型。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | FindVersionMessages |
系统规定参数。取值:FindVersionMessages。 |
| ProjectId | String | 是 | P0VFCREU |
所属项目ID |
| RegionId | String | 是 | cn-shanghai |
地域ID |
| PageIndex | Integer | 是 | 1 |
本页开始序号 |
| PageSize | Integer | 是 | 20 |
分页大小 |
| VersionType | String | 是 | FOTA |
版本类型,取值有:FOTA 系统版本,APP 应用版本。 |
| VersionId | String | 是 | 1 |
版本ID |
| MessageType | String | 否 | VERSION_TEST |
取值有:
|
| TestId | String | 否 | 1 |
测试ID |
| SendRecordId | String | 否 | 1 |
群发记录ID |
| DeviceId | String | 否 | b8fe2e24ff2b48e0a3aa4e49809fc1b3 |
云设备ID |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 6F25F67C-F411-499F-BCE2-67CA563CB064 |
请求ID |
| MessageList |
查询到的消息结果 |
||
| TotalCount | Integer | 5 |
符合条件的记录总数 |
| Items |
结果列表 |
||
| GmtCreateTimestamp | Long | 18974500000 |
创建时间戳 |
| GmtModifyTimestamp | Long | 18974500000 |
修改时间戳 |
| Id | Long | 1 |
ID |
| VersionId | String | 1 |
版本ID |
| TestId | String | 1 |
测试ID |
| MessageId | String | 1 |
发送的消息ID |
| DeviceId | String | b8fe2e24ff2b48e0a3aa4e49809fc1b3 |
云设备ID |
| Status | String | SUCCESS |
发送状态 |
| StatusDesc | String | 发送成功 |
发送状态描述 |
| GmtCreate | String | 2018-01-01 00:00:00 |
创建时间 |
| GmtModify | String | 2018-01-01 00:01:00 |
修改时间 |
示例
请求示例
http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=FindVersionMessages
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&PageIndex=1
&PageSize=20
&VersionType=FOTA
&VersionId=1
&<公共请求参数>
正常返回示例
XML 格式
<FindVersionMessagesResponse>
<RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
<MessageList>
<TotalCount>30</TotalCount>
<Items>
<Id>1</Id>
<VersionId>1</VersionId>
<TestId>1</TestId>
<MessageId>1</MessageId>
<DeviceId>b8fe2e24ff2b48e0a3aa4e49809fc1b3</DeviceId>
<Status>SUCCESS</Status>
<StatusDesc>发送成功</StatusDesc>
<GmtCreate>2018-01-01 00:00:00</GmtCreate>
<GmtModify>2018-01-01 00:01:00</GmtModify>
</Items>
</MessageList>
</FindVersionMessagesResponse>
JSON 格式
{
"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
"MessageList":{
"Items":[
{
"Status":"SUCCESS",
"DeviceId":"b8fe2e24ff2b48e0a3aa4e49809fc1b3",
"MessageId":"1",
"StatusDesc":"发送成功",
"VersionId":"1",
"Id":1,
"GmtCreate":"2018-01-01 00:00:00",
"TestId":"1",
"GmtModify":"2018-01-01 00:01:00"
}
],
"TotalCount":30
}
}
错误码
访问错误中心查看更多错误码。