54 lines
3.7 KiB
Markdown
54 lines
3.7 KiB
Markdown
# 黄金矿工临时期 Postman 文件
|
||
|
||
导入以下两个 JSON，选择“黄金矿工临时期 - 测试环境”：
|
||
|
||
- [Collection](gold-miner-test-period.postman_collection.json)
|
||
- [Environment](gold-miner-test-period.postman_environment.json)
|
||
|
||
对应实际接口为 `POST /goldMiner/admin`，动作 `publish_test_period`，不是独立的 `/test-period` 路由。服务器需已部署临时期功能，并同时配置 `PAYMENT_APP_ENV=test`、`GOLD_MINER_TEST_PERIODS_ENABLED=true`。
|
||
|
||
## 默认使用
|
||
|
||
1. 填写环境变量 `baseUrl`（测试服域名，无末尾 `/`）和 `adminToken`（该服 `ADMIN_TOKEN` 的值）。
|
||
2. 发送“发布临时期（默认立即开启 30 分钟）”。首次自动生成期 ID 和当前时间，结束时间为 30 分钟后。
|
||
3. 返回 `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](gold-miner.postman_collection.json) 查询 info 并测试通关、支付、领取和补发。完整部署和规则见 [临时期说明](../TEST-PERIODS.md)。本文件仅在本地验证 JSON、脚本和断言，不会自动发送到真实测试服。
|