3.7 KiB
黄金矿工临时期 Postman 文件
导入以下两个 JSON，选择“黄金矿工临时期 - 测试环境”：
对应实际接口为 POST /goldMiner/admin，动作 publish_test_period，不是独立的 /test-period 路由。服务器需已部署临时期功能，并同时配置 PAYMENT_APP_ENV=test、GOLD_MINER_TEST_PERIODS_ENABLED=true。
默认使用
- 填写环境变量
baseUrl（测试服域名，无末尾/）和adminToken（该服ADMIN_TOKEN的值）。 - 发送“发布临时期（默认立即开启 30 分钟）”。首次自动生成期 ID 和当前时间，结束时间为 30 分钟后。
- 返回
code:1表示发布成功；Tests 验证返回的期 ID、时间、商品、奖励快照和顺延目标。
默认配置：通过主线 41 关获得资格，价格 100 分，累计通关 1/2/3 次分别获得 100/200/300 金币。配置可在发送前通过 tempConfig 修改。管理发布不自动解锁玩家权益，也不模拟支付或发放奖励。
环境变量
| 变量 | 含义 |
|---|---|
| baseUrl | 测试服地址，必填 |
| adminToken | 管理口令，必填，标记为 secret；导出分享环境文件前清空 |
| tempPeriodId | 可留空自动生成 goldMiner:test:UUID，也可手填独立标识 |
| tempStartsAt | 可留空使用本机当前时间；手填时为 Unix 毫秒整数 |
| tempEndsAt | 可留空按开始时间加持续分钟数生成；手填时必须晚于开始时间 |
| tempDurationMinutes | 结束时间留空时使用，默认 30，正整数 |
| tempNextPeriodId | 可选顺延期 ID；留空使用后端默认下一正常周四 |
| tempConfig | 完整业务配置 JSON，含版本、门槛、价格及任务奖励 |
| tempDraftBaseUrl | 脚本保存的生成环境地址，避免切换服务器后误用旧期次 |
开始时间可以早于服务器当前时间，方便立即开启；新发布的结束时间必须晚于服务器当前时间。自动时间取自本机，本机时钟需与服务器同步。
重试与新一期
脚本首次生成的 tempPeriodId/tempStartsAt/tempEndsAt 会写回当前环境，因此重复 Send 不会改变时间或新开一期；管理口令只在发送时组装进请求，不另存到缓存请求体。
修改 tempDurationMinutes 不会重算已经保存的 tempEndsAt。已发布期的时间、奖励和顺延目标不可修改。
新开一期时，先确认时间不与已发布临时期重叠，再清空 tempPeriodId/tempStartsAt/tempEndsAt，或手填新的期 ID 与不重叠的时间。切换服务器时建议复制一份新环境；否则也需清空 tempDraftBaseUrl。不要删除仍有关联订单或补发奖励的服务器历史排期。
要验证跨临时期顺延，先发布下一临时期，记下它的 ID；再设置当前期的独立 ID、较早起止时间，并把 tempNextPeriodId 填成下一期 ID。下一期开始时间不得早于当前期结束时间。
常见响应
UNAUTHORIZED：管理员口令不匹配。TEST_PERIOD_DISABLED：服务器未同时满足两个测试环境开关。INVALID_PERIOD：时间、期 ID 或顺延目标不合法，或新活动已经结束。CONFIG_UNAVAILABLE：奖励配置不合法、修改已发布期，或临时期重叠。
发布失败时检查响应 msg。Pre-request Script 提示缺少参数而跳过请求不代表测试通过。
发布后，可用原 黄金矿工场景 Collection 查询 info 并测试通关、支付、领取和补发。完整部署和规则见 临时期说明。本文件仅在本地验证 JSON、脚本和断言，不会自动发送到真实测试服。