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