微信小程序前后端开发与150+API对接

解决的具体问题

原生微信小程序开发中，前后端对接的麻烦通常集中在三处：接口数量多且分散，通用、账号、用户、内容、商品、购物车、结算等模块混在一起，人工整理容易漏参数；鉴权逻辑重复，每次请求都要补 guid、authorization、shopId，维护成本高；业务边界不清晰，商城能力常常被硬编码，想做资讯、分销、会员或表单小程序时，交易模块又很难拆掉。

技能如何工作

该技能围绕优社云 OpenAPI（dev.ushopun.com）提供一套通用小程序开发规范，接口前缀统一为 /api/v1，返回体统一为 ApiResponse。核心能力包括：

• 统一请求封装：通过 api/api.js 和 api/conf.js 收敛请求入口，自动处理鉴权 Header。
• 鉴权分级：[ApiAuthorize] 表示必须登录，[ApiAuthorize(false)] 表示匿名可访问，无标记表示公开接口。
• 状态码处理：200 渲染 Data，250 用 wx.showToast 提示，301 做页面跳转，401 清 token 并跳登录，403/404/220/350 分别对应模块未开启、数据不存在、需升级、审核未通过。
• 业务模块可裁剪：商品、购物车、订单等交易模块是可选的，剔除后可以生成纯资讯、纯分销、纯会员、纯表单小程序。

对接时先配置后端地址和接口常量，再按页面调用 api.get(conf.xxx, params) 或 api.post(conf.xxx, data)。例如 /api/v1/common/banner 返回轮播图，/api/v1/account/login 返回 AccessToken，/api/v1/customer/info 获取用户信息。注意 /account/checkaccount 的 Code 是 1 可用 / 0 不可用，不能套用标准状态码。

适用边界与注意点

• 只适用于原生微信小程序，不适用于 Taro、uni-app 等跨端框架。
• 后端数据源固定为优社云 OpenAPI，换成其他后端需要重新适配路径、返回体和鉴权。
• shopId 依赖用户选择门店或自提点后的本地缓存，未选择时相关接口可能失败。
• 富文本可选 wxParse，样式单位统一使用 rpx，图标方案为 iconfont。
• 需要登录的接口如果 authorization 失效，应按 401 处理并跳转登录，而不是继续渲染。