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
|
|||
|
|
================================================================================
|
|||
|
|
|