MatchMaster/docs/CoinMadness后端接口需求.md

黄金矿工前后端接口对齐清单

核对日期：2026-09-30。替代早期模拟版“待实现”需求；旧稿保留在 Git 历史。

字段以 后端 V1.7 为准，实际客户端行为见 实现说明，二者差异见 接入说明。本次没有部署后端。

已调用接口

• goldMiner/index：info、claim、confirm_delivery、settlements、confirm_settlement_delivery。
• activityConfig/list：公共日程；userLevel/save：附带 goldMiner 通关事件；userCoin/save：保存金币总余额。
• wx/orderPaySig、wx/iosorderPaySig：原生下单；wx/getPayInfo、wx/iosgetPayInfo：确认权益。
• 客服当前使用 Utils.GoKEFu，不调用协议中的 create_order；这不代表后端 create_order 已废弃。

优先确认

1. 部署端实际版本和请求环境：当前 testHttpip 与 httpip 相同。
2. 客服支付采用 GoKEFu 还是服务端签名票据；同期订单复用、错误码 16 回退、取消重试和跨期权益。
3. V1.7 补发分页：服务器控页大小，settling 继续可用游标，扫描结束后有限重试，no_pending_rewards 表示无待处理记录。
4. claimStatus 驱动按钮，验证 VIP 六档十任务、pending_unlock 和任意达标档领取；金币保存仍须串行。
5. 保留授权—保存总余额—确认的恢复边界。保存结果不明需核对，不重复加币，不能承诺重装/多设备严格只发一次。

示例价格、目标和周期不能替代已发布配置。验收包括外层成功而活动子结果失败、重复通关、保存成功但确认失败、补发分页、到期竞态和换账号恢复。