MatchMaster/docs/GoldMiner-API-v1.5-changes.md

1.4 KiB
Raw Blame History

黄金矿工接口更新接入

依据用户提供的「黄金矿工」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;这些是本地模拟协议检查,真实支付和云端定时结算仍需测试服联调。