docs: export sign-in Postman collection and test environment

This commit is contained in:
huanghaipeng 2026-09-08 10:16:46 +08:00
parent c3775b7708
commit 31ecbe7ffa
3 changed files with 3401 additions and 0 deletions

View File

@ -0,0 +1,26 @@
# 七日签到 Postman 配置
导入 `sign-in.postman_collection.json` 和 `sign-in.postman_environment.json`,选中环境后填写变量:
| 变量 | 值 |
| --- | --- |
| baseUrl | Laf 应用地址,不带末尾斜杠,如 https://你的APPID.laf.run |
| uid | 主游戏 users 中的测试账号 ID |
| token | 该账号登录 token |
| adminToken | 测试应用环境变量 SIGN_IN_TEST_ADMIN_TOKEN 的值 |
| levelAmount | 设置测试关卡时使用,默认 23 |
配置中不包含真实账号和密钥。可以复制环境模板分别保存测试与生产环境;生产环境不要填写测试管理密钥。
## 使用
- 01:活动信息、原领取接口、错误 token 检查,按需手动发送。原领取接口关闭 HTTP 后不能直接调用。
- 02:inspect、set_level、reset,以及全部 12 种 prepare 场景,按需手动发送。
- 03:只选择此文件夹使用 Runner 顺序运行一次。覆盖未达标、首次开启、Day 1~7、当天重试、当天已领、过期和完成;准备、调用和验证已配套,断言会检查返回快照、当天凭据、开始时间和实际领取数量。
不要直接运行整个 Collection;01、02 是互相独立的手工工具。回归会覆盖同一个测试账号的关卡与签到记录,最后停留在 completed 场景;需要清理时手动发送 02 中的 reset。reset 不会恢复关卡,也不会撤销前端已经发放的资产。
所有请求使用 application/x-www-form-urlencoded。活动信息接口会自动领取,但 canClaim、claimedCount、todayClaimed、status 及 rewards[].claimed 返回领取前快照;todayClaim 是实际落库凭据。前端须按 claimId 去重,并根据 todayClaim.rewards 发奖,Postman 本身不会给客户端增加资产。
生产环境不发布 signInTestAdmin;测试管理请求及 03 回归文件夹仅用于测试环境。回归不会验证真实跨日等待或极端跨零点并发,日期边界和并发需通过服务端专项测试另行验证。

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,36 @@
{
"name": "七日签到 - 环境模板(填写后使用)",
"values": [
{
"key": "baseUrl",
"value": "https://<APPID>.laf.run",
"type": "default",
"enabled": true
},
{
"key": "uid",
"value": "",
"type": "default",
"enabled": true
},
{
"key": "token",
"value": "",
"type": "secret",
"enabled": true
},
{
"key": "adminToken",
"value": "",
"type": "secret",
"enabled": true
},
{
"key": "levelAmount",
"value": "23",
"type": "default",
"enabled": true
}
],
"_postman_variable_scope": "environment"
}