HaniBlindBox/docs/前端适配调整/API接口清单.md
2026-01-03 19:38:08 +08:00

336 lines
17 KiB
Markdown
Raw 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.

# API 接口清单
本文档记录前端所有 API 接口地址,用于核对 C# 后端迁移完整性。
## 概述
- 总接口数:约 120+ 个
- 已迁移:约 129 个
- 未迁移0 个
- 迁移率100%
## 状态说明
| 状态 | 说明 |
|------|------|
| ✅ 已迁移 | C# 后端已实现该接口 |
| ❌ 未迁移 | C# 后端尚未实现该接口 |
| ⚠️ 待确认 | 需要进一步确认迁移状态 |
| 🚫 无需迁移 | 该接口无需迁移到 C# 后端(使用第三方服务或保留原有实现) |
---
## 1. 认证模块 (auth.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/login` | POST | wxLogin | 微信登录 | ✅ 已迁移 |
| `/mobileLogin` | POST | mobileLogin | 手机号验证码登录 | ✅ 已迁移 |
| `/v2/account/sendSms` | POST | sendSms | 发送短信验证码 | 🚫 无需迁移 |
| `/login_bind_mobile` | POST | bindMobileByWx | 微信绑定手机号 | ✅ 已迁移 |
| `/login_bind_mobile_h5` | POST | bindMobileByCode | 验证码绑定手机号(H5) | ✅ 已迁移 |
| `/login_record` | POST | recordLogin | 记录登录 | ✅ 已迁移 |
| `/user_log_off` | POST | logOff | 账号注销 | ✅ 已迁移 |
| `/bind_invite_code` | POST | bindInviteCode | 绑定邀请码 | ✅ 已迁移 |
**使用位置**: pages/user/login.vue, pages/user/bangding.vue, pages/user/bangdingweb.vue, pages/user/cancel-account-page.vue
---
## 2. 用户模块 (user.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/userInfo` | GET | getUserInfo | 获取用户信息 | ✅ 已迁移 |
| `/user` | POST | getUser | 获取用户完整信息 | ✅ 已迁移 |
| `/updateUserInfo` | POST | updateUserInfo | 更新用户信息 | ✅ 已迁移 |
| `/vip_list` | GET | getVipList | 获取VIP等级列表 | ✅ 已迁移 |
| `/profitMoney` | GET | getProfitMoney | 获取余额流水记录 | ✅ 已迁移 |
| `/profitIntegral` | GET | getProfitIntegral | 获取积分流水记录 | ✅ 已迁移 |
| `/profitScore` | GET | getProfitScore | 获取欧气值流水记录 | ✅ 已迁移 |
| `/profitPay` | GET | getProfitPay | 获取消费记录 | ✅ 已迁移 |
| `/quan_yi` | GET | getEquity | 获取权益信息 | ✅ 已迁移 |
| `/quan_yi_ling` | POST | receiveEquity | 领取权益奖励 | ✅ 已迁移 |
| `/task_list` | POST | getTaskList | 获取任务列表 | ✅ 已迁移 |
| `/ling_task` | POST | receiveTaskReward | 领取任务奖励 | ✅ 已迁移 |
| `/withdraw_log` | POST | getWithdrawLog | 获取提现记录 | 🚫 无需迁移 |
| `/withdraw` | POST | submitWithdraw | 提交提现申请 | 🚫 无需迁移 |
**使用位置**: pages/user/index.vue, pages/user/vip.vue, pages/user/bi_jl.vue, pages/user/jf_jl.vue, pages/user/xfjl.vue, package/mine/equity.vue
---
## 3. 商品模块 (goods.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/goods_list` | GET | getGoodsList | 获取商品列表 | ✅ 已迁移 |
| `/goods_detail` | GET | getGoodsDetail | 获取商品详情 | ✅ 已迁移 |
| `/goods_children` | POST | getGoodsChildren | 获取子奖品列表 | ✅ 已迁移 |
| `/goods_extend` | GET | getGoodsExtend | 获取商品扩展配置 | ✅ 已迁移 |
| `/goods_num_list` | GET | getGoodsNumList | 获取箱号列表 | ✅ 已迁移 |
| `/goods_num_detail` | GET | getGoodsNumDetail | 获取箱号详情 | ✅ 已迁移 |
| `/goodslist_count` | GET | getGoodsPrizeCount | 获取奖品数量统计 | ✅ 已迁移 |
| `/goodslist_content` | GET | getGoodsPrizeContent | 获取奖品内容 | ✅ 已迁移 |
| `/goods_prize_logs` | GET | getGoodsPrizeLogs | 获取中奖记录 | ✅ 已迁移 |
| `/yushourili` | GET | getPreSaleCalendar | 获取预售日历 | 🚫 无需迁移 |
| `/ling_zhu_king` | GET | getBossData | 获取领主王数据 | ✅ 已迁移 |
| `/infinite_goodsdetail` | POST | getInfiniteGoodsDetail | 获取无限赏商品详情 | ✅ 已迁移 |
| `/goodsdetail` | POST | getGoodsDetailPost | 获取一番赏商品详情(POST) | ✅ 已迁移 |
| `/infinite_goodsdetail2` | POST | getLianJiGoodsDetail | 获取连击赏商品详情 | ✅ 已迁移 |
| `/shang_log` | POST | getShangLog | 获取一番赏中奖记录 | ✅ 已迁移 |
| `/infinite_shang_log` | POST | getInfiniteShangLog | 获取无限赏中奖记录 | ✅ 已迁移 |
**使用位置**: pages/shouye/index.vue, pages/shouye/detail.vue, pages/shouye/detail_wuxian.vue, pages/shouye/rili.vue, pages/mall/index.vue
---
## 4. 订单模块 (order.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/get_order_status` | GET | getOrderStatus | 获取订单状态 | ✅ 已迁移 |
| `/get_order_list` | GET | getOrderList | 获取订单列表 | ✅ 已迁移 |
| `/create_web_pay_order` | POST | createWebPayOrder | 创建网页支付订单 | ✅ 已迁移 |
| `/get_order_url_link` | POST | getOrderUrlLink | 获取订单链接 | ✅ 已迁移 |
| `/get_user_test` | POST | getUserTest | 获取账号token(测试) | ✅ 已迁移 |
| `/ordermoney` | POST | calcOrderMoney | 一番赏金额计算 | ✅ 已迁移 |
| `/orderbuy` | POST | createOrder | 一番赏下单 | ✅ 已迁移 |
| `/infinite_ordermoney` | POST | calcInfiniteOrderMoney | 无限赏金额计算 | ✅ 已迁移 |
| `/infinite_orderbuy` | POST | createInfiniteOrder | 无限赏下单 | ✅ 已迁移 |
| `/mall_ordermoney` | POST | calcMallOrderMoney | 商城金额计算 | ✅ 已迁移 |
| `/mall_orderbuy` | POST | createMallOrder | 商城下单 | ✅ 已迁移 |
| `/order_detail` | GET/POST | getOrderDetail | 获取订单详情 | ✅ 已迁移 |
| `/prize_order_log` | GET | getPrizeOrderLog | 获取一番赏抽奖结果 | ✅ 已迁移 |
| `/prizeorderlog` | POST | getPrizeOrderLogByNum | 获取一番赏抽奖结果(订单号) | ✅ 已迁移 |
| `/infinite_shang_log` | GET | getInfinitePrizeOrderLog | 获取无限赏抽奖结果 | ✅ 已迁移 |
| `/infinite_prizeorderlog` | POST | getInfinitePrizeOrderLogByNum | 获取无限赏抽奖结果(订单号) | ✅ 已迁移 |
| `/item_card_chou` | POST | useItemCard | 道具卡抽奖 | ✅ 已迁移 |
| `/item_card_list` | GET | getItemCardList | 获取道具卡列表 | ✅ 已迁移 |
| `/used` | POST | useCouponOrder | 使用优惠券下单 | ✅ 已迁移 |
| `/order_list` | POST | getOrderListPaged | 获取订单列表(分页) | ✅ 已迁移 |
| `/infinite_prizerecords` | POST | getInfinitePrizeRecords | 获取无限赏中奖记录 | ✅ 已迁移 |
| `/infinite_mibao_orderbuy` | POST | createInfiniteMibaoOrder | 连击赏秘宝下单 | ✅ 已迁移 |
**使用位置**: pages/shouye/detail.vue, pages/shouye/detail_wuxian.vue, pages/user/order.vue, pages/other/order_list.vue, components/detail-lucky/*.vue, components/order-confirm-popup/*.vue
---
## 5. 仓库模块 (warehouse.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/warehouse_index` | GET | getWarehouseIndex | 获取仓库首页数据 | ✅ 已迁移 |
| `/warehouse_recovery` | POST | recoveryPrize | 回收奖品 | ✅ 已迁移 |
| `/warehouse_send` | POST | sendPrize | 发货奖品 | ✅ 已迁移 |
| `/warehouse_send_confirm` | POST | confirmSend | 确认发货 | ✅ 已迁移 |
| `/warehouse_send_record` | GET | getSendRecord | 获取发货记录列表 | ✅ 已迁移 |
| `/warehouse_send_record_detail` | GET | getSendRecordDetail | 获取发货记录详情 | ✅ 已迁移 |
| `/warehouse_recovery_record` | GET | getRecoveryRecord | 获取回收记录列表 | ✅ 已迁移 |
| `/warehouse_order_logistics` | GET | getLogistics | 获取物流信息 | ✅ 已迁移 |
| `/withdraw` | POST | withdraw | 提现申请 | 🚫 无需迁移 |
| `/withdraw_log` | GET | getWithdrawLog | 获取提现记录 | 🚫 无需迁移 |
| `/warehouse_movein` | POST | moveInSafe | 移入保险柜 | ✅ 已迁移 |
| `/warehouse_remove` | POST | moveOutSafe | 移出保险柜 | ✅ 已迁移 |
**使用位置**: pages/hegui/hegui.vue, pages/user/fhjl.vue, pages/user/hsjl.vue, pages/user/wuliu_detail.vue, package/mine/ti-qu.vue
---
## 6. 优惠券模块 (coupon.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/coupon_list` | GET | getCouponList | 获取优惠券列表 | ✅ 已迁移 |
| `/coupon_detail` | POST | getCouponDetail | 获取优惠券详情 | ✅ 已迁移 |
| `/coupon_ling` | POST | receiveCoupon | 领取优惠券 | ✅ 已迁移 |
| `/receive` | POST | receiveCoupons | 批量领取优惠券 | ✅ 已迁移 |
| `/coupon_share` | POST | shareCoupon | 分享优惠券 | ✅ 已迁移 |
| `/coupon_synthesis` | POST | synthesisCoupon | 合成优惠券 | ✅ 已迁移 |
| `/coupon_ji_suan` | POST | calcSynthesis | 计算合成结果 | ✅ 已迁移 |
| `/coupon` | GET | getAvailableCoupons | 获取可领取的优惠券列表 | ✅ 已迁移 |
| `/used` | GET | getUsedCouponList | 获取可使用的优惠券列表 | ✅ 已迁移 |
| `/t_coupon_list` | POST | getCouponCenterList | 获取领券中心优惠券列表 | ✅ 已迁移 |
| `/t_coupon_ling` | POST | receiveCouponCenter | 领取领券中心优惠券 | ✅ 已迁移 |
**使用位置**: pages/user/coupon.vue, pages/user/my_coupon.vue, package/index/coupon-center.vue, package/mine/coupon-detail.vue, components/coupon-pop/coupon-pop.vue
---
## 7. 福利模块 (welfare.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/fuliwu` | GET/POST | getWelfareHouseList | 获取福利屋列表 | ✅ 已迁移 |
| `/fuliwu_detail` | GET | getWelfareHouseDetail | 获取福利屋详情 | ✅ 已迁移 |
| `/fuliwu_buy` | POST | buyWelfareHouse | 福利屋下单 | ✅ 已迁移 |
| `/fuliwu_participants` | GET | getWelfareParticipants | 获取福利屋参与者列表 | ✅ 已迁移 |
| `/fuliwu_records` | GET | getWelfareRecords | 获取福利屋中奖记录 | ✅ 已迁移 |
| `/sign_info` | GET | getSignInfo | 获取签到信息 | ✅ 已迁移 |
| `/sign` | GET/POST | getSignData/doSign | 签到 | ✅ 已迁移 |
| `/sign_add` | POST | doSignAdd | 执行签到(旧版) | ✅ 已迁移 |
| `/task_list` | GET | getTaskList | 获取任务列表 | ✅ 已迁移 |
| `/ling_task` | POST | receiveTaskReward | 领取任务奖励 | ✅ 已迁移 |
| `/welfare_house_list` | POST | getWelfareMenuList | 获取福利屋菜单列表 | ✅ 已迁移 |
| `/fuliwu_user_records` | GET | getUserWelfareRecords | 获取用户参与记录 | ✅ 已迁移 |
| `/fuliwu_user_winning_records` | GET | getUserWinningRecords | 获取用户中奖记录 | ✅ 已迁移 |
**使用位置**: pages/infinite/index.vue, pages/infinite/bonus_house.vue, pages/infinite/bonus_house_details.vue, pages/infinite/daily_check_in.vue, package/index/sign.vue
---
## 8. 收藏模块 (collection.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/collect_list` | GET | getCollectionList | 获取收藏列表 | ✅ 已迁移 |
| `/addCollect` | POST | addCollection | 添加收藏 | ✅ 已迁移 |
| `/cancelCollect` | POST | cancelCollection | 取消收藏 | ✅ 已迁移 |
| `/collect_status` | GET | getCollectionStatus | 获取收藏状态 | ✅ 已迁移 |
| `/listCollect` | POST | - | 获取收藏列表(POST) | ✅ 已迁移 |
| `/delCollect` | POST | - | 删除收藏 | ✅ 已迁移 |
| `/goods_collection_status` | POST | - | 查询商品收藏状态 | ✅ 已迁移 |
**使用位置**: package/mine/collect.vue, pages/shouye/detail.vue, components/collect-btn/collect-btn.vue
---
## 9. 排行榜模块 (rank.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/getRankList` | GET | getRankList | 获取排行榜列表 | ✅ 已迁移 |
| `/record` | GET | getRecordRank | 获取中奖记录排行榜 | ✅ 已迁移 |
| `/rank_week` | GET | getWeekRank | 获取周榜单 | ✅ 已迁移 |
| `/rank_month` | GET | getMonthRank | 获取月榜单 | ✅ 已迁移 |
**使用位置**: pages/shouye/bangdan.vue, pages/shouye/ranking.vue, pages/shouye/dada_ranking.vue, pages/shouye/yaoqing_ranking.vue
---
## 10. 邀请模块 (invitation.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/invitation` | GET | getInvitationInfo | 获取邀请信息 | ✅ 已迁移 |
| `/invitation` | GET | getInvitationRecord | 获取邀请记录 | ✅ 已迁移 |
| `/bind_invite_code` | POST | bindInviteCode | 绑定邀请码 | ✅ 已迁移 |
**使用位置**: pages/user/tui-guang.vue
---
## 11. 兑换码模块 (redeem.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/redeem_code` | POST | useRedeemCode | 使用兑换码 | ✅ 已迁移 |
| `/redeem_record` | GET | getRedeemRecord | 获取兑换码记录 | ✅ 已迁移 |
| `/used` | POST | - | 使用兑换码(C#) | ✅ 已迁移 |
**使用位置**: pages/user/change.vue
---
## 12. 支付模块 (pay.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/wx_pay` | POST | wxPay | 微信支付 | ✅ 已迁移 |
| `/balance_pay` | POST | balancePay | 余额支付 | ✅ 已迁移 |
| `/recharge` | POST | recharge | 充值 | ✅ 已迁移 |
| `/recharge_config` | GET | getRechargeConfig | 获取充值配置 | ✅ 已迁移 |
| `/create_recharge_order` | POST | createRechargeOrder | 创建充值订单 | ✅ 已迁移 |
| `/query_pay_status` | GET | queryPayStatus | 查询支付状态 | ✅ 已迁移 |
| `/pay` | POST | - | 微信支付统一下单(C#) | ✅ 已迁移 |
**使用位置**: components/pay-dialog/pay-dialog.vue, pages/user/recharge-page.vue, pages/other/web-pay-order.vue
---
## 13. 配置模块 (config.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/config` | GET | getConfig | 获取系统配置 | ✅ 已迁移 |
| `/getPlatformConfig` | GET | getPlatform | 获取平台配置 | ✅ 已迁移 |
| `/getAdvert` | GET | getAdvert | 获取轮播图 | ✅ 已迁移 |
| `/getDanye` | GET | getDanYe | 获取单页规则 | ✅ 已迁移 |
| `/danye` | POST | getDanYeContent | 获取单页内容(POST) | ✅ 已迁移 |
**使用位置**: App.vue, pages/shouye/index.vue, pages/shouye/danye.vue, pages/guize/guize.vue
---
## 14. 地址模块 (userAddress.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/addAddress` | POST | addAddress | 添加收货地址 | ✅ 已迁移 |
| `/updateAddress` | POST | updateAddress | 更新收货地址 | ✅ 已迁移 |
| `/getDefaultAddress` | GET | getDefaultAddress | 获取默认收货地址 | ✅ 已迁移 |
| `/getAddressList` | GET | getAddressList | 获取收货地址列表 | ✅ 已迁移 |
| `/deleteAddress` | POST | deleteAddress | 删除收货地址 | ✅ 已迁移 |
| `/setDefaultAddress` | POST | setDefaultAddress | 设置默认收货地址 | ✅ 已迁移 |
| `/getAddressDetail` | GET | getAddressDetail | 获取地址详情 | ✅ 已迁移 |
**使用位置**: pages/other/address_edit.vue, pages/other/choose_address.vue
---
## 15. 商城模块 (mall.js)
| API 路径 | 请求方式 | 函数名 | 说明 | 迁移状态 |
|----------|----------|--------|------|----------|
| `/get_diamond_list` | GET | getDiamondList | 获取钻石商品列表 | ✅ 已迁移 |
| `/createOrderProducts` | GET | createOrderProducts | 创建钻石订单 | ✅ 已迁移 |
| `/get_diamond_order_log` | GET | getDiamondOrderLog | 获取订单状态 | ✅ 已迁移 |
**使用位置**: pages/mall/index.vue
---
## C# 后端迁移状态详情
### 已迁移接口统计
| 模块 | 已迁移 | 未迁移 | 迁移率 |
|------|--------|--------|--------|
| 认证模块 | 7 | 0 | 100% |
| 用户模块 | 12 | 0 | 100% |
| 商品模块 | 15 | 0 | 100% |
| 订单模块 | 22 | 0 | 100% |
| 仓库模块 | 10 | 0 | 100% |
| 优惠券模块 | 11 | 0 | 100% |
| 福利模块 | 13 | 0 | 100% |
| 收藏模块 | 7 | 0 | 100% |
| 排行榜模块 | 4 | 0 | 100% |
| 邀请模块 | 3 | 0 | 100% |
| 兑换码模块 | 3 | 0 | 100% |
| 支付模块 | 7 | 0 | 100% |
| 配置模块 | 5 | 0 | 100% |
| 地址模块 | 7 | 0 | 100% |
| 商城模块 | 3 | 0 | 100% |
| **总计** | **129** | **0** | **100%** |
### 无需迁移接口说明
以下接口无需迁移到 C# 后端:
| 接口 | 说明 | 原因 |
|------|------|------|
| `/v2/account/sendSms` | 发送短信验证码 | 使用第三方短信服务 |
| `/withdraw_log` | 获取提现记录 | 保留原有实现 |
| `/withdraw` | 提交提现申请 | 保留原有实现 |
| `/yushourili` | 获取预售日历 | 保留原有实现 |
---
## 更新记录
| 日期 | 更新内容 |
|------|----------|
| 2026-01-03 | 初始版本,完成接口清单整理 |
| 2026-01-03 | 添加 C# 后端迁移状态详情和迁移建议 |
| 2026-01-03 | 完成全部54个接口迁移迁移率达到100% |