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

1.2 KiB
Raw Blame History

黄金矿工 V1.5 接入记录(历史)

2026-09-30 校注:本文件记录阶段性变更。仓库最新协议为 V1.7,当前接入程度见 接入说明。

  • 补发改为 settlementId/periodId/rewards;reward 自带 taskId/grantId/items,不再按旧 _id/taskIds 对过期任务 claim。
  • 保存金币后 confirm_settlement_delivery,传 settlementId/grantIds 并验证 confirmedGrantIds,不再调用 ack_settlement。
  • 复用本地交付记录:saved 只补确认,结果不明不重复加币;总余额保存与确认仍不是同一事务。
  • 接入 activityConfig/list,保留成功日程,失败不覆盖;通关原样使用有效服务端期 ID,包括临时期,不再自行计算周四 ID。
  • 当时 settling 退出并重试的行为仍在客户端;V1.7 已要求继续可用游标扫描其他期,尚待对齐。
  • 管理发布、初始化索引、支付回调仍属于后端,不加入玩家客户端。

离线脚本 check-api.cjs、check-api-v15.cjs 保留;旧测试面板及 check-test-tools.cjs 已删除。该记录不能作为线上支付、部署或 V1.7 全量验收证明。