DTS-SHOP 聚惠星商城 API 对接零基础教程微信小程序电商接口一次跑通【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop聚惠星商城DTS-SHOP是一套 SpringBoot Vue 微信小程序技术栈的电商项目后端拆成dts-wx-api小程序侧接口和dts-admin-api管理端接口两个服务。本文以聚惠星商城 API 对接为主线按一个真实用户的下单旅程走一遍带你把微信小程序电商接口逐个接通。哪怕你第一次打开这个项目按顺序做也能完成第一次联调。 这套接口能帮你做到什么商品浏览首页、商品列表、详情、搜索直接接上不用自己造查询逻辑订单履约购物车结算、提交订单、支付、取消、确认收货全链路有接口物流跟踪订单页可拉物流轨迹也可按运单号查状态营销转化优惠券领取与兑换、团购、佣金分销接口现成可用多店铺系统按多店铺模式设计扩展店铺管理即可承接多店铺业务 微信小程序电商接口对接从零到第一次调用成功最短路径一共 4 步参考文章里散落在各处的配置和调试内容都收在这一节拉代码执行git clone https://gitcode.com/gh_mirrors/dt/dts-shop用 IDEA 打开根目录的 Maven 工程。配 API 基础地址打开 wx-mini-program/config/api.js所有接口路径都基于WxApiRoot拼接。本地开发用默认值即可// wx-mini-program/config/api.js var WxApiRoot http://localhost:8070/wx/; // var WxApiRoot https://www.dtsshop.com/wx/; // 生产环境请求头带上 TokenToken登录成功后签发的身份凭证要放在X-Dts-Token请求头里。登录成功后把返回的 token 存进本地缓存之后每次请求自动携带项目里的封装是这样的header: { Content-Type: application/json, X-Dts-Token: wx.getStorageSync(token) }本地起服务验证在dts-wx-api下执行mvn spring-boot:run服务端口 8070小程序开发者工具里请求home/index能拿到 JSON 数据就算接通了。 跟着用户旅程接通主流程下面按用户操作顺序走每节只列主流程关键接口路径相对http://localhost:8070/wx/。微信登录与注册拿到 Token 是第一步auth/login_by_weixin用微信授权 code 登录返回 token 和用户信息auth/register用户名 密码 图形验证码注册账号auth/bindPhone给微信账号绑定手机号之后才能走账密登录和密码重置登录接口通了后面所有接口的身份问题就解决了。商品浏览与搜索列表、详情、搜索home/index首页数据Banner、推荐位一次取回goods/list商品列表支持分页参数// 列表接口通用分页参数 page: 1, // 页码 size: 10 // 每页数量goods/detail商品详情规格、库存、评价入口search/result按关键字搜商品购物车与结算从加购到下单确认cart/add把商品加入购物车cart/fastadd是立即购买跳过购物车cart/checkout购物车结算下单前的信息确认会算好订单金额结算这一步做对了后面order/submit基本不会报错。订单与支付接上微信预支付order/submit提交订单生成待支付订单order/prepay获取预支付会话拿返回参数调wx.requestPayment拉起微信支付order/detail订单详情后续取消、确认收货、评价都以订单 ID 为入口物流查询怎么查订单轨迹order/expressTrace订单详情页的物流轨迹时间线节点express/query按运单号查询物流当前状态用户中心个人中心的数据从哪来user/index个人页面聚合信息订单入口、资产入口collect/list收藏列表footprint/list浏览足迹⚠️ 容易踩的坑错误码、Token、分页与上传响应结构先看 errno接口统一返回 errno 字段0 是成功501 表示未登录或 token 失效小程序端要清掉登录态并跳登录页wx-mini-program/utils/util.js里就是这么处理的。业务错误码查一处具体含义集中在 WxResponseCode.java比如 700 账号密码不对、710 商品已下架、711 库存不足、740 优惠券已领完。做页面提示前先把这段对照表过一遍。服务重启后 Token 会丢token 存在服务端内存里重启dts-wx-api后旧 token 全部失效开发阶段遇到大面积 501 先想到这点。图片上传别用错入口小程序端的用户图片头像、评价图走storage/upload商品图是在 Vue 管理端配的两边别混。 性能与稳定性四条实践缓存分类目录catalog/index、地区数据这类低频变更数据客户端存本地不要每次开页面都请求。图片懒加载商品列表、专题列表的图全部用懒加载避免整屏图片阻塞首屏。请求合并首页要 Banner 推荐 专题时优先调已经聚合好的home/index而不是并排发三四个请求。失败重试只对网络超时做一次短延时重试errno501 这类业务错误不要重试直接走登录流程。✅ 本地联调与上线检查清单本地联调 3 步mvn spring-boot:run起dts-wx-api确认 8070 端口在监听开发者工具里确认WxApiRoot指向本地地址从首页开始逐页走接口报错时翻后端日志日志文件位置由dts-wx-api资源目录下的logback-spring.xml控制上线前检查 3 条api.js切到生产域名且为 HTTPS登录 → 下单 → 支付回调全链路在真机过一遍开发者工具里支付是假的边界场景抽测库存不足、优惠券领完、重复确认收货确认错误码提示正常 上手之后可以继续扩展的方向加自己的接口参考 dts-wx-api/web 目录 下现有 Controller 的写法新增一个RestController就能挂进小程序。接第三方服务短信、邮件、微信模板消息、快递查询在dts-core模块里已有对接实现换application.yml里的配置即可启用。多店铺基于现成的店铺维度数据扩展店铺管理接口即可承接多店铺场景。收尾第一次对接完成清单到这里你手上应该已经有一个能登录、能逛、能下单、能查物流的小程序端DTS-SHOP 开发教程意义上的「第一次对接」就算完成了。对照下面 4 条打勾没勾上的回到对应小节补API 地址已配置首个请求返回 errno0登录、商品、购物车、订单、物流、用户中心六段都手动走通501 未登录和常见业务错误码的处理逻辑已接上生产地址已切换真机完整流程复测通过【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DTS-SHOP 聚惠星商城 API 对接零基础教程：微信小程序电商接口一次跑通
DTS-SHOP 聚惠星商城 API 对接零基础教程微信小程序电商接口一次跑通【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop聚惠星商城DTS-SHOP是一套 SpringBoot Vue 微信小程序技术栈的电商项目后端拆成dts-wx-api小程序侧接口和dts-admin-api管理端接口两个服务。本文以聚惠星商城 API 对接为主线按一个真实用户的下单旅程走一遍带你把微信小程序电商接口逐个接通。哪怕你第一次打开这个项目按顺序做也能完成第一次联调。 这套接口能帮你做到什么商品浏览首页、商品列表、详情、搜索直接接上不用自己造查询逻辑订单履约购物车结算、提交订单、支付、取消、确认收货全链路有接口物流跟踪订单页可拉物流轨迹也可按运单号查状态营销转化优惠券领取与兑换、团购、佣金分销接口现成可用多店铺系统按多店铺模式设计扩展店铺管理即可承接多店铺业务 微信小程序电商接口对接从零到第一次调用成功最短路径一共 4 步参考文章里散落在各处的配置和调试内容都收在这一节拉代码执行git clone https://gitcode.com/gh_mirrors/dt/dts-shop用 IDEA 打开根目录的 Maven 工程。配 API 基础地址打开 wx-mini-program/config/api.js所有接口路径都基于WxApiRoot拼接。本地开发用默认值即可// wx-mini-program/config/api.js var WxApiRoot http://localhost:8070/wx/; // var WxApiRoot https://www.dtsshop.com/wx/; // 生产环境请求头带上 TokenToken登录成功后签发的身份凭证要放在X-Dts-Token请求头里。登录成功后把返回的 token 存进本地缓存之后每次请求自动携带项目里的封装是这样的header: { Content-Type: application/json, X-Dts-Token: wx.getStorageSync(token) }本地起服务验证在dts-wx-api下执行mvn spring-boot:run服务端口 8070小程序开发者工具里请求home/index能拿到 JSON 数据就算接通了。 跟着用户旅程接通主流程下面按用户操作顺序走每节只列主流程关键接口路径相对http://localhost:8070/wx/。微信登录与注册拿到 Token 是第一步auth/login_by_weixin用微信授权 code 登录返回 token 和用户信息auth/register用户名 密码 图形验证码注册账号auth/bindPhone给微信账号绑定手机号之后才能走账密登录和密码重置登录接口通了后面所有接口的身份问题就解决了。商品浏览与搜索列表、详情、搜索home/index首页数据Banner、推荐位一次取回goods/list商品列表支持分页参数// 列表接口通用分页参数 page: 1, // 页码 size: 10 // 每页数量goods/detail商品详情规格、库存、评价入口search/result按关键字搜商品购物车与结算从加购到下单确认cart/add把商品加入购物车cart/fastadd是立即购买跳过购物车cart/checkout购物车结算下单前的信息确认会算好订单金额结算这一步做对了后面order/submit基本不会报错。订单与支付接上微信预支付order/submit提交订单生成待支付订单order/prepay获取预支付会话拿返回参数调wx.requestPayment拉起微信支付order/detail订单详情后续取消、确认收货、评价都以订单 ID 为入口物流查询怎么查订单轨迹order/expressTrace订单详情页的物流轨迹时间线节点express/query按运单号查询物流当前状态用户中心个人中心的数据从哪来user/index个人页面聚合信息订单入口、资产入口collect/list收藏列表footprint/list浏览足迹⚠️ 容易踩的坑错误码、Token、分页与上传响应结构先看 errno接口统一返回 errno 字段0 是成功501 表示未登录或 token 失效小程序端要清掉登录态并跳登录页wx-mini-program/utils/util.js里就是这么处理的。业务错误码查一处具体含义集中在 WxResponseCode.java比如 700 账号密码不对、710 商品已下架、711 库存不足、740 优惠券已领完。做页面提示前先把这段对照表过一遍。服务重启后 Token 会丢token 存在服务端内存里重启dts-wx-api后旧 token 全部失效开发阶段遇到大面积 501 先想到这点。图片上传别用错入口小程序端的用户图片头像、评价图走storage/upload商品图是在 Vue 管理端配的两边别混。 性能与稳定性四条实践缓存分类目录catalog/index、地区数据这类低频变更数据客户端存本地不要每次开页面都请求。图片懒加载商品列表、专题列表的图全部用懒加载避免整屏图片阻塞首屏。请求合并首页要 Banner 推荐 专题时优先调已经聚合好的home/index而不是并排发三四个请求。失败重试只对网络超时做一次短延时重试errno501 这类业务错误不要重试直接走登录流程。✅ 本地联调与上线检查清单本地联调 3 步mvn spring-boot:run起dts-wx-api确认 8070 端口在监听开发者工具里确认WxApiRoot指向本地地址从首页开始逐页走接口报错时翻后端日志日志文件位置由dts-wx-api资源目录下的logback-spring.xml控制上线前检查 3 条api.js切到生产域名且为 HTTPS登录 → 下单 → 支付回调全链路在真机过一遍开发者工具里支付是假的边界场景抽测库存不足、优惠券领完、重复确认收货确认错误码提示正常 上手之后可以继续扩展的方向加自己的接口参考 dts-wx-api/web 目录 下现有 Controller 的写法新增一个RestController就能挂进小程序。接第三方服务短信、邮件、微信模板消息、快递查询在dts-core模块里已有对接实现换application.yml里的配置即可启用。多店铺基于现成的店铺维度数据扩展店铺管理接口即可承接多店铺场景。收尾第一次对接完成清单到这里你手上应该已经有一个能登录、能逛、能下单、能查物流的小程序端DTS-SHOP 开发教程意义上的「第一次对接」就算完成了。对照下面 4 条打勾没勾上的回到对应小节补API 地址已配置首个请求返回 errno0登录、商品、购物车、订单、物流、用户中心六段都手动走通501 未登录和常见业务错误码的处理逻辑已接上生产地址已切换真机完整流程复测通过【免费下载链接】dts-shop微信小程序小程序商城商城springboot框架vue管理系统java后台项目地址: https://gitcode.com/gh_mirrors/dt/dts-shop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考