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

22 KiB
Raw Blame History

API 接口清单

本文档记录前端所有 API 接口地址,用于核对 C# 后端迁移完整性。

概述

  • 总接口数:约 120+ 个
  • 已迁移:约 80+ 个
  • 未迁移:约 40+ 个

状态说明

状态 说明
已迁移 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# 后端实现,需要优先处理:

高优先级(核心功能)

  1. /v2/account/sendSms - 发送短信验证码
  2. /login_bind_mobile_h5 - H5端验证码绑定手机号
  3. /sign_info / /sign / /sign_add - 签到功能
  4. /fuliwu / /fuliwu_buy - 福利屋列表和下单
  5. /wx_pay / /balance_pay / /recharge - 支付相关
  6. /addAddress / /getAddressList 等 - 地址管理
  7. /mall_orderbuy - 商城下单
  8. /infinite_goodsdetail / /infinite_goodsdetail2 - 无限赏/连击赏详情

中优先级(辅助功能)

  1. /quan_yi / /quan_yi_ling - 权益功能
  2. /withdraw / /withdraw_log - 提现功能
  3. /warehouse_movein / /warehouse_remove - 保险柜功能
  4. /yushourili - 预售日历
  5. /ling_zhu_king - 领主王数据
  6. /getRankList / /record - 排行榜
  7. /coupon / /t_coupon_list - 优惠券中心

低优先级(测试/辅助)

  1. /get_user_test - 测试接口
  2. /get_diamond_list 等 - 钻石商城
  3. /redeem_code / /redeem_record - 兑换码

C# 后端迁移状态详情

已迁移接口统计

模块 已迁移 未迁移 迁移率
认证模块 6 2 75%
用户模块 10 4 71%
商品模块 10 6 63%
订单模块 13 9 59%
仓库模块 8 4 67%
优惠券模块 6 5 55%
福利模块 7 6 54%
收藏模块 4 3 57%
排行榜模块 2 2 50%
邀请模块 3 0 100%
兑换码模块 1 2 33%
支付模块 1 6 14%
配置模块 4 1 80%
地址模块 0 7 0%
商城模块 0 3 0%
总计 75 60 56%

未迁移接口详细清单

1. 认证相关 (2个)

接口 说明 优先级
/v2/account/sendSms 发送短信验证码
/login_bind_mobile_h5 H5端验证码绑定手机号

2. 用户相关 (4个)

接口 说明 优先级
/quan_yi 获取权益信息
/quan_yi_ling 领取权益奖励
/withdraw_log 获取提现记录
/withdraw 提交提现申请

3. 商品相关 (6个)

接口 说明 优先级
/yushourili 获取预售日历
/ling_zhu_king 获取领主王数据
/infinite_goodsdetail 获取无限赏商品详情
/goodsdetail 获取一番赏商品详情(POST)
/infinite_goodsdetail2 获取连击赏商品详情
/shang_log 获取一番赏中奖记录

4. 订单相关 (9个)

接口 说明 优先级
/get_order_status 获取订单状态
/get_order_list 获取订单列表
/create_web_pay_order 创建网页支付订单
/get_order_url_link 获取订单链接
/get_user_test 获取账号token(测试)
/mall_orderbuy 商城下单
/prize_order_log 获取一番赏抽奖结果
/item_card_list 获取道具卡列表
/infinite_mibao_orderbuy 连击赏秘宝下单

5. 仓库相关 (4个)

接口 说明 优先级
/withdraw 提现申请
/withdraw_log 获取提现记录
/warehouse_movein 移入保险柜
/warehouse_remove 移出保险柜

6. 优惠券相关 (5个)

接口 说明 优先级
/receive 批量领取优惠券
/coupon 获取可领取的优惠券列表
/used 获取可使用的优惠券列表
/t_coupon_list 获取领券中心优惠券列表
/t_coupon_ling 领取领券中心优惠券

7. 福利相关 (6个)

接口 说明 优先级
/fuliwu 获取福利屋列表
/fuliwu_buy 福利屋下单
/sign_info 获取签到信息
/sign 签到
/sign_add 执行签到(旧版)
/fuliwu (POST) 获取福利屋数据(带类型)

8. 收藏相关 (3个)

接口 说明 优先级
/collect_list 获取收藏列表
/cancelCollect 取消收藏
/collect_status 获取收藏状态

9. 排行榜相关 (2个)

接口 说明 优先级
/getRankList 获取排行榜列表
/record 获取中奖记录排行榜

10. 兑换码相关 (2个)

接口 说明 优先级
/redeem_code 使用兑换码
/redeem_record 获取兑换码记录

11. 支付相关 (6个)

接口 说明 优先级
/wx_pay 微信支付
/balance_pay 余额支付
/recharge 充值
/recharge_config 获取充值配置
/create_recharge_order 创建充值订单
/query_pay_status 查询支付状态

12. 配置相关 (1个)

接口 说明 优先级
/danye 获取单页内容(POST)

13. 地址相关 (7个) - 全部未迁移

接口 说明 优先级
/addAddress 添加收货地址
/updateAddress 更新收货地址
/getDefaultAddress 获取默认收货地址
/getAddressList 获取收货地址列表
/deleteAddress 删除收货地址
/setDefaultAddress 设置默认收货地址
/getAddressDetail 获取地址详情

14. 商城相关 (3个) - 全部未迁移

接口 说明 优先级
/get_diamond_list 获取钻石商品列表
/createOrderProducts 创建钻石订单
/get_diamond_order_log 获取订单状态

迁移建议

第一批次(高优先级 - 核心功能)

  1. 地址模块 - 全部7个接口发货功能依赖
  2. 支付模块 - 6个接口交易核心
  3. 签到功能 - 3个接口用户活跃度
  4. 福利屋 - 2个接口营销功能
  5. 无限赏/连击赏详情 - 2个接口商品展示

第二批次(中优先级 - 辅助功能)

  1. 优惠券中心相关
  2. 提现功能
  3. 权益功能
  4. 排行榜功能
  5. 订单状态查询

第三批次(低优先级 - 可延后)

  1. 钻石商城
  2. 保险柜功能
  3. 测试接口
  4. 兑换码记录

更新记录

日期 更新内容
2026-01-03 初始版本,完成接口清单整理
2026-01-03 添加 C# 后端迁移状态详情和迁移建议