150 lines
3.6 KiB
Markdown
150 lines
3.6 KiB
Markdown
# 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
|
||
|