聚惠星商城 dts-shop API 对接指南30 分钟跑通微信小程序电商核心链路【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop聚惠星商城dts-shop是一套基于微信小程序 SpringBoot Vue 的开源电商系统小程序端的全部后端能力都通过dts-wx-api模块以 RESTful 接口暴露。这篇 dts-shop API 对接指南按架构 → 通用规范 → 业务速查 → 场景串联的顺序带你上手从零启动服务完成首次调用搞清认证与响应约定再独立跑通登录 → 浏览 → 购物车 → 下单支付的完整链路。1. 项目架构鸟瞰这是一个多模块 Maven 工程各模块职责边界清晰dts-wx-api小程序端后端端口 8070所有小程序接口都在这里是本次对接的重点dts-admin-api管理后台后端供 Vue 管理端使用接口风格与小程序端一致dts-daoMyBatis 数据访问层domain/dao/mapper 按表组织dts-core公共能力沉淀存储七牛/阿里云/腾讯云、短信/邮件/微信模板消息、物流查询、响应与校验工具都在此wx-mini-program小程序前端所有接口地址集中在一个配置文件中admin-uiVue Element 管理后台数据流很直白小程序请求打到 dts-wx-api经 Service 层调用 dts-dao 访问 MySQLdts-admin-api 与 dts-wx-api 共用同一套 dts-dao 和 dts-core后台改的商品数据小程序端立即可见。2. 环境准备与首次连通前置条件JDK 1.8、Maven、MySQL、Redis。克隆仓库git clone https://gitcode.com/gh_mirrors/dt/dts-shop执行doc/目录下的 SQL 文件初始化数据库含表结构和演示数据修改 dts-wx-api/src/main/resources/application.yml配置数据库连接、Redis、微信小程序 appid/appsecret服务默认监听 8070 端口在 dts-wx-api 模块执行mvn spring-boot:run启动验证连通按 wx-mini-program/config/api.js 中的本地前缀http://localhost:8070/wx/请求home/index返回errno: 0即打通这个 api.js 值得整文件读一遍它把每个接口路径都配成了具名常量并带中文注释等于一份现成的接口清单后续对接建议直接以它为索引。3. 请求规范与认证机制 读完这一节后面所有业务接口都可以按同一套规则处理基础地址本地http://localhost:8070/wx/线上按实际部署替换全项目只有 api.js 一处需要改认证方式登录成功后从data中拿到token和tokenExpire之后每个需登录的接口在请求头携带X-Dts-Token: {token}。注意不是Authorization写错会静默失败统一响应结构{ errno: 0, errmsg: 成功, data: { } }errno0为成功401/402是参数缺失或参数值非法501表示未登录7xx是业务错误完整定义见 WxResponseCode.java如 710 商品已下架、711 库存不足、724 支付失败分页约定列表接口统一page页码size每页条数从第 1 页开始性能上把握三点分类、地区等低频变更数据在客户端做本地缓存商品图用懒加载幂等的读接口可重试写操作下单、加购不要自动重试避免重复数据。4. 核心业务域接口速查按业务域分组每域只列代表性的端点完整清单以 api.js 为准业务域职责代表性端点路径 / 用途用户认证auth登录、注册、绑定auth/login_by_weixin微信授权登录auth/login账号密码登录auth/register注册商品goods/search浏览与检索goods/list商品列表goods/detail商品详情search/result关键词搜索购物车cart加购与结算前置cart/add加购cart/checkout下单前信息确认cart/fastadd立即购买订单order下单到售后order/submit提交订单order/prepay预支付会话order/expressTrace物流跟踪营销coupon/groupon优惠券与团购coupon/receive领券coupon/selectlist当前订单可用券groupon/join参团用户中心user/address个人中心与地址user/index个人页聚合信息address/save保存地址footprint/list足迹5. 典型场景实战场景一账号登录并拉取商品列表先登录拿 token后续请求全部带上。home/index这类聚合接口不需要登录适合做连通性验证。# 登录 curl -X POST http://localhost:8070/wx/auth/login \ -d usernamedtsadminpassworddtsadmin # 用返回 data.token 请求商品列表 curl http://localhost:8070/wx/goods/list \ -H X-Dts-Token: $TOKEN -d page1size10场景二加入购物车到支付下单前务必走一遍cart/checkout它负责运费、优惠抵扣等金额复核前端确认页直接渲染它的返回。curl -X POST http://localhost:8070/wx/cart/add -H X-Dts-Token: $TOKEN -d productId1skuId1count1 curl -X POST http://localhost:8070/wx/cart/checkout -H X-Dts-Token: $TOKEN curl -X POST http://localhost:8070/wx/order/submit -H X-Dts-Token: $TOKEN -d cartIds1addressId1 curl -X POST http://localhost:8070/wx/order/prepay -H X-Dts-Token: $TOKEN -d orderId1001order/prepay返回微信预支付参数小程序端调起wx.requestPayment完成支付支付结果由服务端回调落库轮询order/detail即可刷新订单状态。6. 排错与调试 现象接口返回errno: 501 请登录原因请求头没带 token、带成了Authorization或 token 已过期解法确认 header 名是X-Dts-Token过期则重新登录刷新本地调试可把 token 存进环境变量统一引用现象返回401 参数不对或402 参数值不对原因漏传必填参数或字段名拼错该项目多为表单参数注意不是 JSON body解法对照 api.js 里的常量名和对应 Controller 的入参逐一核对现象下单时报710/711原因商品在购物车后被下架或库存不足错误码见 WxResponseCode解法前端按errmsg提示用户并触发购物车数据刷新现象改了 8070 端口后小程序请求全部失败原因后端端口与 api.js 前缀不一致解法改端口时同步更新 api.js真机调试还需在小程序后台配置 request 合法域名开发者工具里可临时勾选不校验合法域名调试建议后端接口用 Postman 集合管理把 api.js 转成集合最省事小程序端用微信开发者工具的网络面板观察实际发出的 header 和参数。7. 二次开发与扩展 ⚙️新增业务接口沿现有分层走即可在dts-wx-api/src/main/java/com/qiguliuxing/dts/wx/web/下新建 Controller参考任意现有类的写法返回值统一用 WxResponseUtil业务逻辑落 Service需要落库时直接注入 dts-dao 里的 Service。接口路径记得同步加进 api.js。集成第三方服务优先复用 dts-core短信/邮件/微信模板消息在notify包物流查询在express包对象存储在storage包各自的配置类和 Sender 已按接口 多实现设计新增一个云厂商只需实现对应接口。表结构变更以doc/下的 SQL 文件为基准改完记得同步 MyBatis 生成配置。dts-shop 把微信小程序商城的完整业务闭环——认证、商品、购物车、订单、支付、优惠券、团购、佣金分销——做成了可直接调用的接口接口风格统一、错误码体系完整对接成本主要在熟悉约定而非啃代码。对做技术选型的团队来说它的多模块结构也让只取小程序端后端或只做管理后台成为可能。下一步建议把doc/下的表结构和演示数据跑起来对照本文场景二走一遍完整下单再决定哪些业务域需要定制。更多细节可查阅仓库内 SQL 文档与小程序演示包或加入项目社群参与讨论。【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考