OPPO推送服务测试后台

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

功能特性

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

环境要求

• JDK 1.8+
• Maven 3.6+

配置说明

✅ 配置已完成 - 已在 src/main/resources/application.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运行

mvn spring-boot:run

方式二：打包后运行

# 打包
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. 启动服务

mvn spring-boot:run

2. 使用curl测试

# 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):

{
  "targetValue": "your_registration_id",
  "title": "测试标题",
  "content": "这是一条测试消息",
  "messageType": "1"
}

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

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

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

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

相关文档

• OPPO推送服务文档
• OPPO开放平台

注意事项

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

故障排查

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