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

23 lines
1.7 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.

# 黄金矿工前后端接口对齐清单
核对日期:2026-09-30。替代早期模拟版“待实现”需求;旧稿保留在 Git 历史。
字段以 [后端 V1.7](../server/laf-cloud/functions/goldMiner/FRONTEND-API.md) 为准,实际客户端行为见 [实现说明](../assets/coin_madness/README.md),二者差异见 [接入说明](GoldMiner接入说明.md)。本次没有部署后端。
## 已调用接口
- 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. 保留授权—保存总余额—确认的恢复边界。保存结果不明需核对,不重复加币,不能承诺重装/多设备严格只发一次。
示例价格、目标和周期不能替代已发布配置。验收包括外层成功而活动子结果失败、重复通关、保存成功但确认失败、补发分页、到期竞态和换账号恢复。