14 lines
1.4 KiB
Markdown
14 lines
1.4 KiB
Markdown
# 黄金矿工接口更新接入
|
||
|
||
依据用户提供的「黄金矿工」Postman 集合及 README（V1.5）。玩家补发采用 V1.4 新协议。
|
||
|
||
- 到期清单使用 `settlementId/periodId/rewards`，每个 reward 自带 `taskId/grantId/items`。不再依赖 `_id/taskIds`，不再对过期任务调用 claim。
|
||
- 保存金币后调用 `confirm_settlement_delivery`，传 `settlementId/grantIds`；验证 confirmedGrantIds 后落本地确认状态。新流程不调用 ack_settlement。
|
||
- 复用原有发货日志：已保存金币的凭证只补确认；保存结果不明仍阻止重复加币。金币保存与领奖确认依然不是一个后端事务。
|
||
- settlements 返回 settling 时停止本轮处理，保留当前页，下一次刷新重试；空页仍按 nextCursor 翻页。
|
||
- 接入 activityConfig/list，保留成功日程，失败不覆盖。诊断快照 activitySchedule 可查看。日程不替代玩家 info 状态及入口资格判断。
|
||
- 通关使用后端返回的当前期 ID，支持 goldMiner:test: 临时期及任意星期；不再自行计算周四期号。locked 玩家可借公共日程上报资格关。
|
||
- 管理发布临时期、索引初始化及支付回调仍由后台处理，不加入玩家端。
|
||
|
||
验证：check-api.cjs、check-api-v15.cjs、check-test-tools.cjs；这些是本地模拟协议检查，真实支付和云端定时结算仍需测试服联调。
|