调用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
}
}
错误码
访问错误中心查看更多错误码。