# OPPO推送服务测试后台

这是一个用于测试OPPO推送服务，特别是"通讯与服务（原私信）"类消息的后台服务。

## 功能特性

- ✅ 获取OPPO推送服务的Access Token
- ✅ 发送单点推送消息
- ✅ 支持发送通讯与服务（原私信）类消息
- ✅ 提供RESTful API接口，方便测试和调试

## 环境要求

- JDK 1.8+
- Maven 3.6+

## 配置说明

✅ **配置已完成** - 已在 `src/main/resources/application.properties` 中配置：

```properties
oppo.push.appKey=bb0819c889ae40cd8bde5a8ad4e670fe
oppo.push.appSecret=9b5a0e6d560e406dbb70fbb4e0e38098
oppo.push.channel.id.im=previte_message
oppo.push.channel.name.im=消息推送
```

**注意**：如果您的 MasterSecret 与 AppSecret 不同，请更新配置文件中的 `oppo.push.masterSecret` 值。

## 运行方式

### 方式一：使用Maven运行

```bash
mvn spring-boot:run
```

### 方式二：打包后运行

```bash
# 打包
mvn clean package

# 运行
java -jar target/oppo-push-server-1.0.0.jar
```

## API接口

### 1. 健康检查

```
GET http://localhost:8080/api/push/health
```

### 2. 获取Access Token

```
GET http://localhost:8080/api/push/token
```

### 3. 发送通讯与服务（原私信）类消息

```
POST http://localhost:8080/api/push/send
Content-Type: application/json

{
  "targetValue": "registration_id或alias",
  "title": "消息标题",
  "content": "消息内容",
  "messageType": "1"
}
```

**参数说明：**
- `targetValue`: 目标值，可以是registration_id、alias或tag
- `title`: 消息标题
- `content`: 消息内容
- `messageType`: 消息类型（1:通知栏消息, 2:透传消息），默认为1

## 快速测试

### 1. 启动服务

```bash
mvn spring-boot:run
```

### 2. 使用curl测试

```bash
# 1. 健康检查
curl http://localhost:8080/api/push/health

# 2. 获取Token（测试认证是否成功）
curl http://localhost:8080/api/push/token

# 3. 发送通讯与服务（原私信）类消息
curl -X POST http://localhost:8080/api/push/send \
  -H "Content-Type: application/json" \
  -d @test-request.json
```

**注意**：发送消息前，请先修改 `test-request.json` 文件中的 `targetValue` 为实际的 registration_id。

### 使用Postman测试

1. 创建新的POST请求
2. URL: `http://localhost:8080/api/push/send`
3. Headers: `Content-Type: application/json`
4. Body (raw JSON):
```json
{
  "targetValue": "your_registration_id",
  "title": "测试标题",
  "content": "这是一条测试消息",
  "messageType": "1"
}
```

## 通讯与服务（原私信）类消息说明

根据OPPO推送服务文档，通讯与服务类消息需要设置特殊的参数：

- `message_type`: 设置为 "chat" 标识为私信类消息
- `channel_id`: 私信频道ID，已配置为 `previte_message`
- `channel_name`: 频道名称，已配置为 `消息推送`

这些参数已经在 `OppoPushService` 中自动设置，使用配置文件中定义的频道ID和名称。

## 相关文档

- [OPPO推送服务文档](https://open.oppomobile.com/documentation/page/info?id=11233)
- [OPPO开放平台](https://open.oppomobile.com)

## 注意事项

1. 确保在OPPO开放平台已开通推送服务
2. 确保AppKey、AppSecret和MasterSecret配置正确
3. 确保目标设备的registration_id或alias有效
4. Access Token会自动缓存，有效期约24小时

## 故障排查

1. **获取Token失败**：检查AppKey和MasterSecret是否正确
2. **发送消息失败**：检查targetValue是否有效，以及网络连接是否正常
3. **消息未收到**：检查设备是否在线，以及应用是否已正确集成OPPO推送SDK