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

13 lines
1.2 KiB
Markdown
Raw Permalink 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.

# 黄金矿工 V1.5 接入记录(历史)
2026-09-30 校注:本文件记录阶段性变更。仓库最新协议为 [V1.7](../server/laf-cloud/functions/goldMiner/FRONTEND-API.md),当前接入程度见 [接入说明](GoldMiner接入说明.md)。
- 补发改为 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 全量验收证明。