微信小程序前后端开发(含150+API接口一键前后端对接生成)

miniProgram/
├── api/
│   ├── conf.js          # 所有 API 端点常量（统一管理，禁止硬编码 URL）
│   └── api.js           # HTTP 请求封装（自动注入 guid/token/shopId）
├── pages/               # 业务页面（每页 .js/.wxml/.wxss/.json 四件套）
│   ├── index/           # 通用首页（轮播 + 自定义业务入口）
│   ├── login/           # 账号登录注册页（通用）
│   ├── member/          # 通用个人中心
│   ├── address/         # 地址管理（交易类通用）
│   ├── blog/            # 资讯文章（内容类）
│   ├── agent-center/    # 分销代理中心
│   ├── coupon/          # 优惠券中心
│   ├── wallet/          # 钱包资产中心
│   ├── form-page/       # 通用自定义表单收集页
│   ├── cart/            # 购物车（电商可选）
│   └── order/           # 订单列表/详情（交易可选）
├── components/          # 通用可复用组件（非商城专属）
├── utils/               # 工具函数（时间格式化、脱敏、缓存等）
├── images/              # 静态图片资源
├── data/                # 静态数据（省市区、字典等）
├── app.js               # 全局入口（globalData + onLaunch）
├── app.json             # 应用配置（页面路由、TabBar、窗口样式）
└── app.wxss             # 全局样式入口

// app.js globalData
globalData: {
  host: 'https://dev.ushopun.com',   // 后端 API 基础地址（不含 /api/v2）
  token: '',                          // 登录后写入的 JWT Token
  guid: '',                           // 登录后写入的用户 GUID
  customer: null                      // 当前用户信息
}

{
  "code": 200,
  "content": "请求成功！",
  "data": { },
  "success": true
}

// api/api.js
const app = getApp()

const request = (url, options) => {
  return new Promise((resolve, reject) => {
    const fullUrl = `${app.globalData.host}/api/v2${url}`

    wx.request({
      url: fullUrl,
      method: options.method,
      data: options.method === 'GET' ? options.data : JSON.stringify(options.data),
      header: {
        'Content-Type': 'application/json; charset=UTF-8',
        guid: wx.getStorageSync('guid') || app.globalData.guid || '',
        authorization: wx.getStorageSync('token') || app.globalData.token || '',
        shopId: (wx.getStorageSync('adress') && wx.getStorageSync('adress').id) || 0
      },
      success(request) {
        const res = request.data || {}
        if (res.code === 200) {
          resolve(res)          // 成功，调用方取 res.data
        } else if (res.code === 401) {
          wx.removeStorageSync('token')
          wx.removeStorageSync('guid')
          wx.navigateTo({ url: '/pages/login/login' })
          reject(res)
        } else {
          reject(res)           // 250 业务警告 / 404 等，调用方用 content 提示
        }
      },
      fail(error) {
        wx.showToast({ title: '网络异常，请稍后重试', icon: 'none' })
        reject(error)
      }
    })
  })
}

const get    = (url, options = {}) => request(url, { method: 'GET',    data: options })
const post   = (url, options)      => request(url, { method: 'POST',   data: options })
const put    = (url, options)      => request(url, { method: 'PUT',    data: options })
const remove = (url, options)      => request(url, { method: 'DELETE', data: options })

module.exports = { get, post, put, remove }

import api from '../../api/api'
import { productId, orderList } from '../../api/conf'

Page({
  data: { model: {}, list: [] },
  onLoad(options) {
    // GET 调用
    api.get(productId, { id: options.id })
      .then(res => this.setData({ model: res.data }))
      .catch(err => wx.showToast({ title: err.content || '加载失败', icon: 'none' }))

    // POST 调用
    api.post(orderList, { orderstatus: 0, page: 1 })
      .then(res => this.setData({ list: res.data.items }))
      .catch(err => wx.showToast({ title: err.content || '加载失败', icon: 'none' }))
  }
})

api.get(banner, { name: 'homehotbanner' }).then(res => this.setData({ banners: res.data.items }))
api.post(allprovinces).then(res => this.setData({ provinces: res.data }))
api.post(uploadpicture, { upload: { base64: 'data:image/png;base64,...' } })
api.post(formsubmit, { name: 'consult', model: { phone: '138...', content: '...' } })

// 1. 账号密码登录
api.post(login, { model: { name: '13800138000', password: '123456' } })
  .then(res => {
    // res.data = { guid, token, nickname }
    wx.setStorageSync('guid', res.data.guid)
    wx.setStorageSync('token', res.data.token)
  })

// 2. 注册（先发验证码）
api.post(sendsmsforregister, { phone: '13800138000' })
api.post(register, { model: { phone: '13800138000', password: '123456', token: '短信验证码', inviteCode: '邀请码' } })

// 3. 检查账号可用性（特殊：code=1 可用）
api.get(checkaccount, { account: '13800138000' }).then(res => {
  if (res.code === 1) { /* 可用 */ } else { /* 已存在 */ }
})

api.get(getcustomer).then(res => this.setData({ customer: res.data }))
api.get(myinvitecode).then(res => this.setData({ inviteCode: res.data.code }))
api.get(myinvitees, { page: 1, size: 12 }).then(res => this.setData({ invitees: res.data }))

api.get(addressList).then(res => this.setData({ list: res.data }))
api.post(addressadd, { model: { name: '张三', phone: '138...', provinceName: '广东省', address: '...' } })
api.post(addressdelete, { addressId: 123 })

api.get(topicdetail, { systemName: 'about' }).then(res => this.setData({ body: res.data.body })) // 富文本
api.get(newslist, { page: 1, size: 12 }).then(res => this.setData({ news: res.data }))
api.post(blogpost, { model: { title: '...', content: '...' } })

api.get(productId, { id: 123 }).then(res => this.setData({ product: res.data }))
api.get(homePro, { picsize: 200 }).then(res => this.setData({ products: res.data }))
api.get(getproductattr, { pId: 123 }).then(res => this.setData({ attrs: res.data.attrs, tables: res.data.tables }))

api.get(search, { q: '关键词', page: 1, size: 12 }).then(res => this.setData({ result: res.data }))
api.get(searCate, { cid: 10, page: 1, size: 12 }).then(res => this.setData({ items: res.data.items }))
api.get(hotsearch).then(res => this.setData({ hot: res.data }))

api.get(getShoppingcart).then(res => this.setData({ cart: res.data }))
api.post(producttocart, { model: { pId: 123, qty: 1, attrValue: 'combination_1_2' } })
api.post(updatecartitem, { item: { id: 1, quantity: 2, selected: true } })
api.get(cartCount).then(res => this.setData({ count: res.data }))

api.get(getcheckout).then(res => this.setData({ checkout: res.data }))
api.post(submitcheckout, { request: { addressId: 1, paymentMethod: 'weixin', remark: '...', couponId: 0 } })
  .then(res => { /* res.data 含订单信息 */ })

api.get(orderList, { orderstatus: 0, page: 1, size: 12 }).then(res => this.setData({ orders: res.data.items }))
api.get(orderDetail, { oid: 123 }).then(res => this.setData({ order: res.data }))
api.post(ordercancel, { mo: { orderGuid: '...' } })
api.post(orderconfirm, { mo: { orderGuid: '...' } })

api.get(weixinopenpaymenturl, { orderId: 123, paytype: 'Order' }).then(res => {
  const p = res.data  // MoPayment 含支付参数
  wx.requestPayment({
    timeStamp: p.timeStamp, nonceStr: p.nonceStr,
    package: p.package, signType: p.signType, paySign: p.paySign,
    success() { /* 支付成功 */ },
    fail() { /* 支付失败 */ }
  })
})

api.get(wallet).then(res => this.setData({ wallet: res.data }))
api.post(walletrecharge, { model: { amount: 100 } }).then(res => this.setData({ recharge: res.data }))
api.get(walletrecordlist, { page: 1, size: 12 }).then(res => this.setData({ records: res.data.items }))

api.get(coupon_center, { page: 1, size: 12 }).then(res => this.setData({ coupons: res.data }))
api.post(getcoupon, { request: { code: 'xxx' } }).then(() => wx.showToast({ title: '领取成功' }))
api.get(usablecoupon, { orderTotal: 100 }).then(res => this.setData({ usable: res.data }))

api.get(agentmyinfo).then(res => this.setData({ agent: res.data }))
api.get(agentupgrade).then(res => {
  if (res.code === 200) { /* 已代理 */ }
  else if (res.code === 220) { /* 需申请，弹出申请表单 */ }
})
api.get(agentmybonus, { page: 1, size: 12 }).then(res => this.setData({ bonus: res.data }))

// ============ 通用 Common ============
const banner              = '/common/banner'
const referrerinfo        = '/common/referrerinfo'
const referrerauto        = '/common/referrerauto'
const forminfo            = '/common/forminfo'
const formsubmit          = '/common/formsubmit'
const getform             = '/common/getform'
const levels              = '/common/levels'
const allprovinces        = '/common/allprovinces'
const uploadpicture       = '/common/uploadpicture'
const picturepost         = '/common/picturepost'
const producttype         = '/common/producttype'
const orderstatus         = '/common/orderstatus'
const ordertype           = '/common/ordertype'
const returnreasons       = '/common/returnreasons'
const returnactions       = '/common/returnactions'
const requesttypes        = '/common/requesttypes'
const paymentstatus       = '/common/paymentstatus'
const shippingstatus      = '/common/shippingstatus'
const pluginscenes        = '/common/pluginscenes'
const customattrtype      = '/common/customattrtype'
const messagetype         = '/common/messagetype'

// ============ 账号 Account ============
const login               = '/account/login'
const online              = '/account/online'
const logout              = '/account/logout'
const register            = '/account/register'
const sendsmsforregister  = '/account/sendsmsforregister'
const chanagepwd          = '/account/chanagepwd'
const sendsmsforfindpwd   = '/account/sendsmsforfindpwd'
const pwdset              = '/account/pwdset'
const checkaccount        = '/account/checkaccount'

// ============ 用户 Customer ============
const getcustomer         = '/customer/get'
const customerinfo        = '/customer/info'
const customersubmit      = '/customer/submit'
const customerpoints      = '/customer/points'
const uploadavatar        = '/customer/uploadavatar'
const checkshop           = '/customer/checkshop'
const myinvitecode        = '/customer/myinvitecode'
const myinvitees          = '/customer/myinvitees'

// ============ 地址 Address ============
const addressList         = '/address/list'
const addressdelete       = '/address/delete'
const addressadd          = '/address/add'
const addressdefault      = '/address/default'
const addressedit         = '/address/edit'

// ============ 消息 PM ============
const pmmarkRead          = '/pm/markRead'
const pmsend              = '/pm/send'
const pmlist              = '/pm/list'
const pmdelpm             = '/pm/delpm'

// ============ 内容 Topic / News / Blog ============
const topiclist           = '/topic/list'
const topicdetail         = '/topic/detail'
const newslist            = '/news/list'
const newsitem            = '/news/item'
const bloglist            = '/blog/list'
const blogitem            = '/blog/item'
const blogpost            = '/blog/post'
const blogcategories      = '/blog/categories'
const blogpapers          = '/blog/papers'

// ============ 商品 Product ============
const featuredbycid       = '/product/featuredbycid'
const homePro             = '/product/homeproducts'
const specialproducts     = '/product/specialproducts'
const alsopurchased       = '/product/alsopurchased'
const taglist             = '/product/taglist'
const productbytag        = '/product/getbytag'
const getproductattr      = '/product/getproductattr'
const getproductspec      = '/product/getproductspec'
const productId           = '/product/getbyid'
const productbysku        = '/product/getbysku'
const productpost         = '/product/post'

// ============ 分类 / 品牌 / 搜索 ============
const homecategories      = '/category/homecategories'
const categoryget         = '/category/get'
const category            = '/category/sublist'
const brandlist           = '/brand/list'
const brandfeaturelist    = '/brand/featurelist'
const brandget            = '/brand/get'
const brandfeaturedproducts = '/brand/featuredproducts'
const search              = '/search/find'
const searCate            = '/search/findbycid'
const findbymid           = '/search/findbymid'
const findbyoid           = '/search/findbyoid'
const hotcategory         = '/search/hotcategory'
const hotsearch           = '/search/hot'
const searchhistory       = '/search/history'

// ============ 收藏 / 阶梯价 ============
const favoriteslist       = '/favorites/list'
const favoritessubmit     = '/favorites/submit'
const favoritesremove     = '/favorites/remove'
const recentproductlist   = '/favorites/list-recentproduct'
const recentproductsubmit = '/favorites/submit-recentproduct'
const recentproductremove = '/favorites/remove-recentproduct'
const tierprices          = '/tierprice/tierprices'

// ============ 购物车 ShoppingCart ============
const getShoppingcart     = '/shoppingcart/get'
const cartCount           = '/shoppingcart/count'
const producttocart       = '/shoppingcart/producttocart'
const productstocart      = '/shoppingcart/productstocart'
const producttocheckout   = '/shoppingcart/producttocheckout'
const cartallselected     = '/shoppingcart/cartallselected'
const updatecartitem      = '/shoppingcart/updatecartitem'
const removecartitem      = '/shoppingcart/removecartitem'
const removecart          = '/shoppingcart/removecart'
const wishlist            = '/shoppingcart/wishlist'
const removewishlistitem  = '/shoppingcart/removewishlistitem'
const iscollect           = '/shoppingcart/iscollect'
const towishlist          = '/shoppingcart/towishlist'
const tocheckout          = '/shoppingcart/tocheckout'

// ============ 结算 Checkout ============
const checkminsubtotal    = '/checkout/checkminsubtotal'
const getcheckout         = '/checkout/get'
const getpaymentmethod    = '/checkout/getpaymentmethod'
const getshippingmethod   = '/checkout/getshippingmethod'
const submitcheckout      = '/checkout/submit'
const quicksubmit         = '/checkout/quicksubmit'

// ============ 订单 Order ============
const returnrequests      = '/order/returnrequests'
const returnpost          = '/order/returnpost'
const orderList           = '/order/list'
const orderDetail         = '/order/detail'
const orderconfirm        = '/order/complete'
const orderdeliver        = '/order/deliver'
const ordercancel         = '/order/cancel'

// ============ 物流 Shipping / Kdniao ============
const pickuplist          = '/shipping/pickuplist'
const shopsearch          = '/shipping/shopsearch'
const shipments           = '/shipping/shipments'
const expresskdniaoapiurl = '/kdniao/expresskdniaoapiurl'

// ============ 支付 Plugin ============
const weixinwaploginenabled    = '/plugin/weixinwaploginenabled'
const weixinwaploginurl        = '/plugin/weixinwaploginurl'
const weixinopenloginenabled   = '/plugin/weixinopenloginenabled'
const weixinopenlogin          = '/plugin/weixinopenlogin'
const weixinopenphonenumber    = '/plugin/weixinopenphonenumber'
const weixinwappaymentenabled  = '/plugin/weixinwappaymentenabled'
const weixinwapaymenturl       = '/plugin/weixinwapaymenturl'
const weixinopenpaymentenabled = '/plugin/weixinopenpaymentenabled'
const weixinopenpaymenturl     = '/plugin/weixinopenpaymenturl'
const alipaywappaymentenabled  = '/plugin/alipaywappaymentenabled'
const alipaywappaymenturl      = '/plugin/alipaywappaymenturl'

// ============ 钱包 Wallet ============
const wallet              = '/wallet/get'
const walletrecharge      = '/wallet/recharge'
const walletrechargelist  = '/wallet/rechargelist'
const walletexchange      = '/wallet/exchange'
const walletexchangelist  = '/wallet/exchangelist'
const walletcardexchange  = '/wallet/cardexchange'
const walletrecordlist    = '/wallet/recordlist'

// ============ 积分 / 充值卡 ============
const pointsexchangelist  = '/pointsexchange/list'
const pointsexchange      = '/pointsexchange/exchange'
const rechargecardlist    = '/rechargecard/list'
const rechargecarditem    = '/rechargecard/item'
const rechargecarditemlist = '/rechargecarditem/list'
const rechargecarditemget = '/rechargecarditem/item'

// ============ 优惠券 Coupon ============
const couponshow          = '/coupon/show'
const couponlist          = '/coupon/couponlist'
const coupon_center       = '/coupon/center'
const getcoupon           = '/coupon/getcoupon'
const usablecoupon        = '/coupon/usablecoupon'

// ============ 秒杀 / 拼团 / 签到 / 任务 / 分享 / 预售 ============
const seckillstatus       = '/seckill/status'
const seckilllist         = '/seckill/list'
const pintuanproduct      = '/pintuan/product'
const pintuangroup        = '/pintuan/group'
const pintuankaituan      = '/pintuan/kaituan'
const signinstatus        = '/signin/status'
const signin              = '/signin/signin'
const signinrecords       = '/signin/records'
const signincalendar      = '/signin/calendar'
const tasklist            = '/task/list'
const taskclaim           = '/task/claim'
const taskunclaimed       = '/task/unclaimed'
const sharereward         = '/share/reward'
const preorderpayrest     = '/preorder/pay-rest'
const preorderrestinfo    = '/preorder/rest-info'

// ============ 代理 Agent ============
const agentupgrade        = '/agents/upgrade'
const agentmyinfo         = '/agents/myinfo'
const agentspostinfo      = '/agents/postinfo'
const agentmysummary      = '/agents/mysummary'
const agentmyusers        = '/agents/myusers'
const agentmyorders       = '/agents/myorders'
const agentmybonus        = '/agents/mybonus'

// ============ 评价 Review ============
const commentlist         = '/productreview/list'
const myreviews           = '/productreview/myreviews'
const productreviewing    = '/productreview/productreviewing'
const commentsubmit       = '/productreview/submit'

// ============ 捆绑 / 页面 ============
const bundlelist          = '/bundle/list'
const pageindex           = '/page/index'
const pagefeaturelist     = '/page/featurelist'
const pageget             = '/page/get'
const pagefeaturedproducts = '/page/featuredproducts'

module.exports = {
  // Common
  banner, referrerinfo, referrerauto, forminfo, formsubmit, getform, levels,
  allprovinces, uploadpicture, picturepost, producttype, orderstatus, ordertype,
  returnreasons, returnactions, requesttypes, paymentstatus, shippingstatus,
  pluginscenes, customattrtype, messagetype,
  // Account
  login, online, logout, register, sendsmsforregister, chanagepwd,
  sendsmsforfindpwd, pwdset, checkaccount,
  // Customer
  getcustomer, customerinfo, customersubmit, customerpoints, uploadavatar,
  checkshop, myinvitecode, myinvitees,
  // Address
  addressList, addressdelete, addressadd, addressdefault, addressedit,
  // PM
  pmmarkRead, pmsend, pmlist, pmdelpm,
  // Topic/News/Blog
  topiclist, topicdetail, newslist, newsitem, bloglist, blogitem, blogpost,
  blogcategories, blogpapers,
  // Product
  featuredbycid, homePro, specialproducts, alsopurchased, taglist, productbytag,
  getproductattr, getproductspec, productId, productbysku, productpost,
  // Category/Brand/Search
  homecategories, categoryget, category, brandlist, brandfeaturelist, brandget,
  brandfeaturedproducts, search, searCate, findbymid, findbyoid, hotcategory,
  hotsearch, searchhistory,
  // Favorites/TierPrice
  favoriteslist, favoritessubmit, favoritesremove, recentproductlist,
  recentproductsubmit, recentproductremove, tierprices,
  // ShoppingCart
  getShoppingcart, cartCount, producttocart, productstocart, producttocheckout,
  cartallselected, updatecartitem, removecartitem, removecart, wishlist,
  removewishlistitem, iscollect, towishlist, tocheckout,
  // Checkout
  checkminsubtotal, getcheckout, getpaymentmethod, getshippingmethod,
  submitcheckout, quicksubmit,
  // Order
  returnrequests, returnpost, orderList, orderDetail, orderconfirm, orderdeliver,
  ordercancel,
  // Shipping/Kdniao
  pickuplist, shopsearch, shipments, expresskdniaoapiurl,
  // Plugin
  weixinwaploginenabled, weixinwaploginurl, weixinopenloginenabled,
  weixinopenlogin, weixinopenphonenumber, weixinwappaymentenabled,
  weixinwapaymenturl, weixinopenpaymentenabled, weixinopenpaymenturl,
  alipaywappaymentenabled, alipaywappaymenturl,
  // Wallet
  wallet, walletrecharge, walletrechargelist, walletexchange, walletexchangelist,
  walletcardexchange, walletrecordlist,
  // Points/RechargeCard
  pointsexchangelist, pointsexchange, rechargecardlist, rechargecarditem,
  rechargecarditemlist, rechargecarditemget,
  // Coupon
  couponshow, couponlist, coupon_center, getcoupon, usablecoupon,
  // Seckill/PinTuan/SignIn/Task/Share/PreOrder
  seckillstatus, seckilllist, pintuanproduct, pintuangroup, pintuankaituan,
  signinstatus, signin, signinrecords, signincalendar, tasklist, taskclaim,
  taskunclaimed, sharereward, preorderpayrest, preorderrestinfo,
  // Agent
  agentupgrade, agentmyinfo, agentspostinfo, agentmysummary, agentmyusers,
  agentmyorders, agentmybonus,
  // Review
  commentlist, myreviews, productreviewing, commentsubmit,
  // Bundle/Page
  bundlelist, pageindex, pagefeaturelist, pageget, pagefeaturedproducts
}

① 账号密码登录：
   api.post(login, { model: { name, password } })
   → res.data = { guid, token, nickname }
   → wx.setStorageSync('guid', guid); wx.setStorageSync('token', token)

② 微信授权登录：
   wx.login() → code
   → wx.getUserProfile() → encryptedData, iv
   → api.get(weixinopenlogin, { code, state, encryptedData, iv })
   → res.data = { guid, token, openId }（TokenEntity）
   → 存储 guid + token

③ 绑定手机号：
   <button open-type="getPhoneNumber">
   → api.get(weixinopenphonenumber, { code, encryptedData, iv })
   → res.data = { phone }

详情选 SKU → 加入购物车(producttocart) / 立即购买(producttocheckout)
  → 购物车列表勾选(getShoppingcart + cartallselected)
  → 结算页(getcheckout)选地址/优惠券/支付方式
  → api.post(submitcheckout, { request: {...} }) → 创建订单
  → api.get(weixinopenpaymenturl, { orderId, paytype }) → 支付参数
  → wx.requestPayment → 支付成功 → 跳转支付成功页

用户分享（path 携带 code）→ 新用户进入存储 code
  → api.get(referrerauto) → 自动绑定推荐关系
  → 新用户下单 → 推荐人获佣金/分红
  → 代理中心(agentmyinfo/mysummary/mybonus)查看收益

import api from '../../api/api'
import { /* 需要的端点 */ } from '../../api/conf'

Page({
  data: { /* 响应式变量 */ },
  onLoad(options) { /* 页面加载，处理路由参数 */ },
  onShow() { /* 页面显示/切回前台 */ },
  onReady() { /* 初次渲染完成 */ },
  getData() { /* 业务方法，驼峰命名，动词开头 */ },
  onShareAppMessage() { return { title: '分享标题', path: '/pages/xxx/xxx?id=' + this.data.id } }
})