245 lines
7.0 KiB
Plaintext
245 lines
7.0 KiB
Plaintext
================================================================================
|
||
Postman 测试 Honor 推送详细操作指南
|
||
================================================================================
|
||
|
||
方法一：导入配置文件（推荐）
|
||
================================================================================
|
||
|
||
步骤1：打开 Postman
|
||
- 启动 Postman 应用程序
|
||
|
||
步骤2：导入配置文件
|
||
- 点击左上角的 "Import" 按钮
|
||
- 选择 "File" 标签
|
||
- 浏览并选择文件：test_push_postman.json
|
||
- 点击 "Import" 完成导入
|
||
|
||
步骤3：使用导入的请求
|
||
- 在左侧 Collections 中找到 "Honor Push Test"
|
||
- 点击 "Send Honor Push" 请求
|
||
- 修改 deviceToken 为实际的设备Token
|
||
- 点击 "Send" 按钮发送请求
|
||
|
||
步骤4：查看响应
|
||
- 在底部 Response 区域查看返回结果
|
||
- 如果返回 "ok" 表示请求已接收
|
||
|
||
|
||
方法二：手动创建请求（详细步骤）
|
||
================================================================================
|
||
|
||
步骤1：创建新请求
|
||
- 点击左上角的 "+" 或 "New" 按钮
|
||
- 选择 "HTTP Request"
|
||
- 或者直接点击 "New" 标签页
|
||
|
||
步骤2：设置请求方法
|
||
- 在请求方法下拉菜单中选择 "POST"
|
||
- 默认是 "GET"，需要改为 "POST"
|
||
|
||
步骤3：输入请求URL
|
||
- 在 URL 输入框中输入：
|
||
http://localhost:8080/android/push
|
||
|
||
步骤4：设置请求头（Headers）
|
||
- 点击 "Headers" 标签
|
||
- 添加以下请求头：
|
||
Key: Content-Type
|
||
Value: application/json;charset=UTF-8
|
||
- 注意：取消勾选 "Content-Type" 旁边的自动添加选项（如果有）
|
||
|
||
步骤5：设置请求体（Body）
|
||
- 点击 "Body" 标签
|
||
- 选择 "raw" 选项
|
||
- 在右侧下拉菜单中选择 "JSON"
|
||
- 在文本框中输入以下JSON内容：
|
||
|
||
{
|
||
"sender": "test_sender_001",
|
||
"senderName": "测试用户",
|
||
"senderPortrait": "",
|
||
"convType": 0,
|
||
"target": "honor_device_001",
|
||
"targetName": "Honor设备",
|
||
"targetPortrait": "",
|
||
"userId": "honor_device_001",
|
||
"line": 0,
|
||
"cntType": 1,
|
||
"serverTime": 1767511609324,
|
||
"pushMessageType": 0,
|
||
"pushType": 8,
|
||
"pushContent": "这是一条使用Postman发送的测试推送消息",
|
||
"pushData": "",
|
||
"unReceivedMsg": 1,
|
||
"mentionedType": 0,
|
||
"packageName": "com.xunpaisoft.social.im",
|
||
"deviceToken": "BAEAAAAAB.josybFY8YYNOK7suCSammWuFIaIUgCdo1d5Ud2NBTUWnyy2a8yUG2WpwNiTZFgBW3sRPO_q-a1bWjwu_ODI6HWHHszoUi1HbhlhMaxjHmOs-zxfg--SECc",
|
||
"voipDeviceToken": "",
|
||
"isHiddenDetail": false,
|
||
"language": "zh_CN",
|
||
"messageId": 0,
|
||
"callStartUid": 0,
|
||
"republish": false,
|
||
"existBadgeNumber": 0
|
||
}
|
||
|
||
步骤6：修改参数（重要）
|
||
- 将 "deviceToken" 的值改为实际的设备Token
|
||
- 将 "serverTime" 改为当前时间戳（毫秒）
|
||
可以使用在线工具获取，或使用JavaScript：Date.now()
|
||
- 可以修改 "pushContent" 为自定义的推送内容
|
||
- 可以修改 "senderName" 为自定义的发送者名称
|
||
|
||
步骤7：发送请求
|
||
- 点击右上角的蓝色 "Send" 按钮
|
||
- 等待响应返回
|
||
|
||
步骤8：查看响应结果
|
||
- 在底部 "Response" 区域查看结果
|
||
- 如果状态码是 200，响应内容是 "ok"，表示请求成功
|
||
- 可以查看 "Headers"、"Body"、"Cookies" 等详细信息
|
||
|
||
|
||
重要参数说明
|
||
================================================================================
|
||
|
||
必须修改的参数：
|
||
1. deviceToken: 设备Token，必须使用实际的设备Token
|
||
格式：BAEAAAAAB.xxxxx...
|
||
|
||
2. serverTime: 服务器时间戳（毫秒）
|
||
可以使用当前时间：Date.now() 或 new Date().getTime()
|
||
示例：1767511609324
|
||
|
||
可选修改的参数：
|
||
1. pushContent: 推送消息内容
|
||
示例："这是一条测试推送消息"
|
||
|
||
2. senderName: 发送者名称
|
||
示例："测试用户"
|
||
|
||
3. target: 接收者ID
|
||
示例："honor_device_001"
|
||
|
||
4. sender: 发送者ID
|
||
示例："test_sender_001"
|
||
|
||
|
||
使用环境变量（高级用法）
|
||
================================================================================
|
||
|
||
步骤1：创建环境
|
||
- 点击右上角的 "No Environment" 下拉菜单
|
||
- 选择 "Manage Environments"
|
||
- 点击 "Add" 创建新环境
|
||
- 命名为 "Push Test"
|
||
|
||
步骤2：添加变量
|
||
在环境中添加以下变量：
|
||
- base_url: http://localhost:8080
|
||
- device_token: 你的设备Token
|
||
- app_package: com.xunpaisoft.social.im
|
||
|
||
步骤3：在请求中使用变量
|
||
- URL中使用：{{base_url}}/android/push
|
||
- Body中使用：{{device_token}}、{{app_package}}
|
||
|
||
步骤4：切换环境
|
||
- 在右上角选择创建的环境
|
||
- 这样可以在不同环境间快速切换
|
||
|
||
|
||
常见问题
|
||
================================================================================
|
||
|
||
问题1：返回 404 Not Found
|
||
解决：
|
||
- 检查URL是否正确：http://localhost:8080/android/push
|
||
- 确认推送服务正在运行
|
||
- 检查端口是否为8080
|
||
|
||
问题2：返回 400 Bad Request
|
||
解决：
|
||
- 检查JSON格式是否正确
|
||
- 确认Content-Type设置为application/json
|
||
- 检查必填字段是否都有值
|
||
|
||
问题3：返回 "unknown push type"
|
||
解决：
|
||
- 确认 pushType 设置为 8（不是9）
|
||
- 检查JSON中的pushType字段
|
||
|
||
问题4：JSON格式错误
|
||
解决：
|
||
- 使用Postman的格式化功能（点击"Pretty"）
|
||
- 检查是否有未闭合的括号
|
||
- 检查字符串是否用双引号
|
||
|
||
问题5：无法连接到服务器
|
||
解决：
|
||
- 检查推送服务是否启动
|
||
- 检查防火墙设置
|
||
- 尝试使用 127.0.0.1 代替 localhost
|
||
|
||
|
||
快速测试步骤（简化版）
|
||
================================================================================
|
||
|
||
1. 打开Postman
|
||
2. 点击 "New" → "HTTP Request"
|
||
3. 方法选择 "POST"
|
||
4. URL输入：http://localhost:8080/android/push
|
||
5. 点击 "Body" → 选择 "raw" → 选择 "JSON"
|
||
6. 粘贴以下JSON（记得修改deviceToken）：
|
||
|
||
{
|
||
"sender": "test_sender_001",
|
||
"senderName": "测试用户",
|
||
"convType": 0,
|
||
"target": "honor_device_001",
|
||
"targetName": "Honor设备",
|
||
"userId": "honor_device_001",
|
||
"line": 0,
|
||
"cntType": 1,
|
||
"serverTime": 1767511609324,
|
||
"pushMessageType": 0,
|
||
"pushType": 8,
|
||
"pushContent": "Postman测试消息",
|
||
"pushData": "",
|
||
"unReceivedMsg": 1,
|
||
"mentionedType": 0,
|
||
"packageName": "com.xunpaisoft.social.im",
|
||
"deviceToken": "你的设备Token",
|
||
"voipDeviceToken": "",
|
||
"isHiddenDetail": false,
|
||
"language": "zh_CN",
|
||
"messageId": 0,
|
||
"callStartUid": 0,
|
||
"republish": false,
|
||
"existBadgeNumber": 0
|
||
}
|
||
|
||
7. 点击 "Send"
|
||
8. 查看响应结果
|
||
|
||
|
||
保存请求（便于重复使用）
|
||
================================================================================
|
||
|
||
步骤1：保存请求
|
||
- 点击 "Save" 按钮
|
||
- 输入请求名称，如："Honor Push Test"
|
||
- 选择或创建Collection（集合）
|
||
- 点击 "Save"
|
||
|
||
步骤2：重复使用
|
||
- 在左侧 Collections 中找到保存的请求
|
||
- 点击即可使用
|
||
- 可以修改参数后再次发送
|
||
|
||
|
||
================================================================================
|
||
文档生成时间：2026-01-04
|
||
================================================================================
|
||
|