# 测试服务端通知

> phone | 2in1 | tablet | tv | wearable

## 功能介绍

> phone | 2in1 | tablet | tv | wearable

此接口用于测试服务端通知。

## 场景描述

> phone | 2in1 | tablet | tv | wearable

开发者调用此接口，IAP服务器向开发者服务器发送测试通知。
> 说明
>
> 1. 5分钟内只允许调用一次，在开发者服务器收到测试通知后，不建议再次调用此接口。
>
> 2. 测试通知只支持开发者的生产环境通知地址。
>
> 3. 测试通知主类型为TEST，无通知子类型，具体请参见[NotificationType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-key-event-notifications#notificationtype)说明。

## 接口原型

> phone | 2in1 | tablet | tv | wearable

* **承载协议：** HTTPS POST

* **接口方向：** 开发者服务器 -> IAP服务器

* **接口URL：** {rootUrl}/harmony/v1/application/notifications/test

  说明：rootUrl具体请参见[站点信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-rest-common-statement#站点信息)。
* **数据格式：**

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

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

## 请求参数

> phone | 2in1 | tablet | tv | wearable

### Request Header

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:------------|:---|:-----|:--------------------------------------------------------------------------------------------------------------------------------------------|
|Content-Type|是|String|取值为：application/json;charset=UTF-8|
|Authorization|是|String|认证信息，使用JWT进行鉴权，具体请参见[Authorization说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-jwt-description#authorization说明)。|

## 请求示例

> phone | 2in1 | tablet | tv | wearable

```javascript
POST /harmony/v1/application/notifications/test
Content-Type: application/json;charset=UTF-8
Authorization: Bearer ***.***.***
Accept: application/json
```

## 响应参数

> phone | 2in1 | tablet | tv | wearable

### Response Header

> phone | 2in1 | tablet | tv | wearable

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

### Response Body

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:-----------------|:---|:-----|:------------------------------------------------------------------------------------------------------------------|
|responseCode|是|String|返回码。 0：成功 其他：失败，具体请参见[错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-server-error-code)|
|responseMessage|否|String|响应描述。|
|testNotificationId|是|String|测试通知ID。|

## 响应示例

> phone | 2in1 | tablet | tv | wearable

```javascript
HTTP/1.2 200 OK
Content-Type: application/json;charset=UTF-8
{
  "responseCode": "0",
  "testNotificationId": "***"
}
```

## 测试服务端通知样例

> phone | 2in1 | tablet | tv | wearable

```javascript
{
  "notificationType": "TEST", // 固定为TEST
  "notificationRequestId": "xxx",
  "notificationMetaData": {
    "environment": "NORMAL", // 固定为NORMAL
    "applicationId": "xxx", // 应用ID
    "packageName": "testPackageName", // 固定为testPackageName
    "type": 0, // 固定为0
    "purchaseToken": "xxx", // 前缀固定为testPurchaseToken，后面为应用ID
    "purchaseOrderId": "xxx" // 前缀固定为testPurchaseOrderId，后面为应用ID
  },
  "notificationVersion": "v3", // 固定为v3
  "signedTime": 1747445946282
}
```