UrShop 小程序商城开发规范

对接 UrShop（优社电商）后端开发微信小程序商城时，最消耗精力的部分往往不是页面布局，而是梳理十几个模块的接口路径、参数规则和状态码语义。如果没有统一的请求封装和接口清单，开发者很容易在鉴权注入、店铺上下文传递、SKU 多属性联动上反复踩坑。

它解决什么问题

这个技能把 UrShop 的 RESTful API 整理成前端可直接对照的规范。它统一了 api/api.js 请求入口，自动处理鉴权和店铺上下文，避免每个页面手写请求头。所有响应遵循固定格式：Code 为 200 表示成功，220 表示需审核或待处理，250 表示业务成功但需特殊逻辑，401 触发重新登录，其余值从 Content 字段读取错误描述。这让错误处理能在网络层集中完成，而不是散落在每个页面。

核心能力与关键步骤

技能覆盖 16 个模块的接口：

• 用户与商品：认证、首页、商品详情、SKU 属性、分类、搜索
• 交易链路：购物车、收藏、结算下单、支付、订单管理、地址、物流
• 运营扩展：钱包、优惠券、评价、分销、代理

每个端点都给出常量名、路径、方法和关键参数。例如商品详情用 productId 拉取 Data，SKU 联动依赖 getproductattr 返回的 attrs 和 tables，提交订单时 submitcheckout 需要 AddressId、PaymentMethod 等字段，支付环节通过 paymentweixinwap 获取微信支付参数后调用 wx.requestPayment。

页面实现部分也给出具体指引。首页按轮播图、分类入口、热卖标签、热门分类商品分块组装；商品详情页解析 SpecialStartDate 和 SpecialEndDate 做特价倒计时；购物车支持单选、全选、数量更新和批量删除；结算页在提交前先用 checkminsubtotal 校验最低消费，再用 usablecoupon 和 wallet 分别拉取可用券和余额。个人中心的代理申请根据 agentsupgrade 返回的 Code 分流：200 直接进入分销，220 则弹出表单。

适用边界与注意点

技能本身只提供对接规范和页面实现参考，不包含 UrShop 后端部署包。你需要先从 UrShop 官网或优社电商获取包含数据库脚本、API 服务和管理后台的部署包，才能在本地跑通完整链路。前端代码仍需自行搭建，技能的作用是让你不必重新发明轮子，把精力放在业务定制上。