server/laf-cloud/postman/sign-in.README.md

27 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 七日签到 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 回归文件夹仅用于测试环境。回归不会验证真实跨日等待或极端跨零点并发,日期边界和并发需通过服务端专项测试另行验证。