承载协议： HTTPS POST
接口方向： 开发者服务器 -> IAP服务器
接口URL： {rootUrl}/harmony/v1/application/notifications/query

说明：rootUrl具体请参见站点信息。
数据格式：

请求消息：Content-Type: application/json; charset=UTF-8

响应消息：Content-Type: application/json; charset=UTF-8

请求参数

Request Header

展开

参数	是否必选	参数类型	描述
Content-Type	是	String	取值为：application/json;charset=UTF-8
Authorization	是	String	认证信息，使用JWT进行鉴权，具体请参见Authorization说明。

Request Body

展开

参数	是否必选	参数类型	描述
startTime	是	Long	指定查询范围的开始时间，UTC时间戳，以毫秒为单位。说明： - startTime不能大于当前时间。 - 查询时间范围不超过最近30天。
endTime	是	Long	指定查询范围的结束时间，UTC时间戳，以毫秒为单位。 - endTime不能大于当前时间。 - 结束时间endTime必须大于开始时间startTime。
notificationType	否	String	通知主类型，不传查所有通知类型。通知主类型，具体请参见表NotificationType说明
sendResult	否	Integer	通知发送结果，不传则查成功与失败的记录。 0：成功 1：失败
purchaseOrderIdList	否	List<String>	购买订单ID列表。
continuationToken	否	String	支持分页查询的数据定位标志。初始请求时无需输入，当响应结果返回continuationToken时，下一次查询时需要输入上次查询返回的continuationToken才可以查询下一页数据。

请求示例

POST /harmony/v1/application/notifications/query
Content-Type: application/json;charset=UTF-8
Authorization: Bearer ***.***.***
Accept: application/json
{
  "startTime": 1751299200000,
  "endTime": 1751472000000
}

响应参数

Response Header

展开

参数	是否必选	参数类型	描述
Content-Type	是	String	取值为：application/json;charset=UTF-8

Response Body

展开

参数	是否必选	参数类型	描述
responseCode	是	String	返回码。 0：成功失败，具体请参见错误码
responseMessage	否	String	响应描述。
notificationHistory	否	List<Object>	历史通知记录信息。具体请参见NotificationHistory说明。
continuationToken	否	String	支持分页查询的数据定位标志。如果返回，下一次查询请求时需要输入，以此查询下一页数据。

NotificationHistory

展开

参数	是否必选	参数类型	描述
jwsNotification	是	String	通知内容信息，对通知内容NotificationPayload签名后的字符串。具体请参见表NotificationPayload。需要参见对返回结果验签使用JWS签名方式对NotificationPayload消息体进行验签。
sendResult	是	Integer	通知发送结果。 0：成功 1：失败

参数

是否必选

参数类型

描述

jwsNotification

是

String

通知内容信息，对通知内容NotificationPayload签名后的字符串。具体请参见表NotificationPayload。

需要参见对返回结果验签使用JWS签名方式对NotificationPayload消息体进行验签。

sendResult

是

Integer

通知发送结果。

0：成功

1：失败

响应示例

HTTP/1.2 200 OK
Content-Type: application/json;charset=UTF-8
{
  "responseCode": "0",
  "notificationHistory": [
    {
      "jwsNotification": "****",
      "sendResult": 0
    },
    {
      "jwsNotification": "****",
      "sendResult": 1
    }
  ],
  "continuationToken": "***"
}

查询用户的历史购买记录

测试服务端通知

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问