调用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

取值有:

  • VERSION_TEST:系统版本测试消息推送
  • SYSTEM_UPDATE:系统版本发布消息推送
  • APP_VERSION_TEST:应用自升级测试消息推送
  • APP_VERSION_UPDATE:应用自升级发布消息推送
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
	}
}

错误码

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