微信小程序拼团后端接口设计规范.V2

最新推荐文章于 2023-02-16 13:47:59 发布
最新推荐文章于 2023-02-16 13:47:59 发布
阅读量617 收藏 4
点赞数 1
文章标签： 后端 json java
原文链接：https://segmentfault.com/a/1190000015437612
版权

概要

来源：https://share.notestore.cn/40...

基于拼团后端接口简约的特点，我们拟定了后端小程序拼团接口设计指南和建议。
适合 0 - 1 构建拼团商城不错参考。

公告列表

接口地址：

Api/Banner/lists
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "banners": [
        {
        }
    ]
}

商品列表

接口地址：

Api/Goods/lists?offset=OFFSET&size=SIZE
请求参数
参数必填说明
offset是偏移量
size是条数
返回说明
//正常返回的JSON数据包
{
    "goods": [
        {
           
        }
    ],
    "result": "ok"
}

//数据为空返回，返回的JSON数据包
{
    "goods": [],
    "result": "ok"
}

商品详情

接口地址：

Api/Goods/detail?goods_id=GOODS_ID
请求参数
参数必填说明
goods_id是商品ID
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "goods": {
        
    },
    "gallery": [
        {
           
        }
    ]
}

//错误时返回JSON数据包(示例为Goods_ID无效)
{
    "result": "fail",
    "error_code": 41002,
    "error_info": "商品已下架或不存在"
}

订单列表

接口地址：

Api/Weuser/order?offset=OFFSET&size=SIZE&token=TOKEN
请求参数
参数必填说明
offset是偏移量
size是条数
token是登陆令牌
返回说明
//正常返回的JSON数据包
{
    "order_list": [
        {
        }
    ],
    "result": "ok"
}

//数据为空返回，返回的JSON数据包
{
    "order_list": [],
    "result": "ok"
}

订单详情

接口地址：

Api/Weuser/getorder?token=TOKEN&order_id=ORDER_ID
请求参数
参数必填说明
order_id是订单ID
token是登陆令牌
返回说明
//正常返回的JSON数据包
{
    "order": {
    },
    "result": "ok"
}

//错误时返回JSON数据包(示例为Order_ID无效)
{
    "result": "fail",
    "error_code": 41001,
    "error_info": "订单不存在"
}

生成订单

接口地址：

http请求方式: POST
Api/Weuser/orders?token=TOKEN

各订单类型所需的JSON数据包如下：

生成单购订单

{
    "goods_id": "GOODS_ID",
    "address_id": "ADDRESS_ID",
    "groupbuy": 0,
    "group_order_id": 0
}

生成团购订单

{
    "goods_id": "GOODS_ID",
    "address_id": "ADDRESS_ID",
    "groupbuy": 1,
    "group_order_id": 0
}

生成参团订单

{
    "goods_id": "GOODS_ID",
    "address_id": "ADDRESS_ID",
    "groupbuy": 1,
    "group_order_id": GROUP_ORDER_ID
}
请求参数
参数必填说明
token是登陆令牌
goods_id是商品ID
address_id是用户地址ID
groupbuy是是否团购订单
group_order_id是参团ID
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "order_id": 16
}

//错误时返回JSON数据包(示例为Goods_ID无效)
{
  "result" : "fail",
  "error_code" : 41002,
  "error_info" : "该商品不存在"
}
返回码说明
参数说明
41002商品不存在
42042商品已售罄
42042地址不存在
41002商品一人限购
41003团不存在
41003团已满员
41003团已关闭
41003已加入过此团
41002创建订单失败

取消订单

接口地址：

Api/Weuser/cancelOrder?token=TOKEN&order_id=ORDER_ID
请求参数
参数必填说明
order_id是订单ID
token是登陆令牌
返回说明
//正常返回的JSON数据包
{
    "result": "ok"
}

订单状态 

//订单状态
"order_status": {
    0: "待支付",
    1: "已支付，未确认",
    2: "已确认，待发货",
    3: "配送中",
    4: "已签收",
    5: "交易已取消",
    6: "未发货退款处理中",
    7: "未发货退款成功",
    8: "已发货退款处理中",
    9: "已发货退款成功"
},

地址列表

接口地址：

Api/Weuser/addresses?token=TOKEN
请求参数
参数必填说明
token是登陆令牌
返回说明
//正常返回的JSON数据包
{
  "address_list" : [
    {
    }
  ],
  "result" : "ok"
}

添加地址

接口地址：(TOKEN 需换成登陆令牌)

api/Weuser/address?token=TOKEN

HTTP请求方式：

POST
POST参数说明：
参数必填说明
receive_name是收货人名字
mobile是手机号
province是省份ID
city是城市ID
district是地区ID
address_name是地址类别 “HOME” "WORK"
address是详细地址

示例：

{
    "receive_name": "RECEIVE_NAME",
    "mobile": "MOBILE",
    "province": "PROVINCE",
    "city": "CITY",
    "district": "DISTRICT",
    "address_name": "HOME",
    "address": "ADDRESS"
}
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "address_id": 15
}

修改地址

接口地址：(TOKEN 需换成登陆令牌 / ADDRESS_ID 需换成地址ID) 

api/Weuser/address?address_id=ADDRESS_ID&token=TOKEN

HTTP请求方式：

PUT
PUT参数说明：
参数必填说明
receive_name是收货人名字
mobile是手机号
province是省份ID
city是城市ID
district是地区ID
address_name是地址类别 “HOME” "WORK"
address是详细地址

示例：

{
    "receive_name": "RECEIVE_NAME",
    "mobile": "MOBILE",
    "province": "PROVINCE",
    "city": "CITY",
    "district": "DISTRICT",
    "address_name": "HOME",
    "address": "ADDRESS"
}
返回说明
//正常返回的JSON数据包
{
    "result": "ok"
}

设置默认地址

接口地址：(TOKEN 需换成登陆令牌 / ADDRESS_ID 需换成地址ID) 

Api/Weuser/addresses?token=TOKEN&address_id=ADDRESS_ID

HTTP请求方式：

PUT
PUT参数说明：
参数必填说明
status是DEFAULT

示例：

{
    "status": "DEFAULT"
}
返回说明
//正常返回的JSON数据包
{
    "result": "ok"
}

删除地址

接口地址：(TOKEN 需换成登陆令牌 / ADDRESS_ID 需换成地址ID) 

Api/Weuser/address?address_id=ADDRESS_ID&token=TOKEN

HTTP请求方式：

DELETE
返回说明
//正常返回的JSON数据包
{
    "result": "ok"
}

拼团列表

接口地址：

Api/Weuser/groups?offset=OFFSET&size=SIZE&token=TOKEN
请求参数
参数必填说明
offset是偏移量
size是条数
返回说明
//正常返回的JSON数据包
{
    "group_orders": [
        {
        }
    ],
    "result": "ok"
}

//数据为空返回，返回的JSON数据包
{
    "group_orders": [],
    "result": "ok"
}

拼团详情

接口地址：

Api/Weuser/group_orders?token=TOKEN&id=ID
请求参数
参数必填说明
id是拼团ID
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "group_order": {
    }
}

//错误时返回JSON数据包(示例为团ID无效)
{
    "result": "fail",
    "error_code": 41001,
    "error_info": "该团不存在"
}
拼团状态
    "group_status": {
    }

微信支付

接口地址：

Api/Weuser/wxpay?token=TOKEN&order_id=ORDER_ID
请求参数
参数必填说明
token是登陆令牌
order_id是订单ID
返回说明
//正常返回的JSON数据包
{
    "param": {
        "appId": "APPID",
        "nonceStr": "NONCESTR",
        "package": "prepay_id=PREPAY_ID",
        "signType": "MD5",
        "timeStamp": "1528247090",
        "paySign": "PAYSIGN"
    },
    "result": "ok"
}

//错误时返回JSON数据包(示例为Order_ID无效)
{
    "result": "fail",
    "error_code": 41001,
    "error_info": "订单不存在"
}
返回码说明
参数说明
41001订单不存在
41002商品不存在
42042商品已售罄
42042地址不存在
41002商品一人限购
41003团不存在
41003团已满员
41003团已关闭
41003已加入过此团

用户信息

接口地址：

Api/Weuser/me?token=TOKEN
请求参数
参数必填说明
token是登陆令牌
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "user_info": {
    }
}

//错误时返回JSON数据包(示例为Token无效)
{
    "result": "fail",
    "error_code": 40001,
    "error_info": "用户校验失败"
}

微信类

小程序登陆

接口地址：

Api/WeApp/login?code=CODE
请求参数
参数必填说明
code是wx.login(OBJECT) success 返回 参数 code
返回说明
//正常返回的JSON数据包
{
    "access_token": "ACCESS_TOKEN",
    "expires": "15282507217200",
    "refresh_token": "REFRESH_TOKEN",
    "result": "ok",
    "user_sn": "4998",
    "token": "TOKEN"
}

//错误时返回JSON数据包(示例为Code无效)
{
    "result": "fail",
    "error_code": 42032,
    "error_info": "获取用户信息失败"
}

同步用户信息

接口地址：(TOKEN 需换成登陆令牌) 

Api/WeApp/login?token=TOKEN

HTTP请求方式：

PUT

PUT参数说明：

参数必填说明
encryptedData是包括敏感数据在内的完整用户信息的加密数据
iv是加密算法的初始向量

注意：请求参数 来源于 wx.getUserInfo

示例：

{
    "iv": "IV",
    "encryptedData": ENCRYPTEDDATA"
}
返回说明
//正常返回的JSON数据包
{
    "result": "ok"
}

通用类

地区列表

接口地址：

Api/project/regions
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "regions": {
    }
}

地区数据版本

接口地址：

Api/Project/data_version?type=region_list
请求参数
参数必填说明
type是region_list
返回说明
//正常返回的JSON数据包
{
    "result": "ok",
    "data_version": {
        "data_key": "region_list",
        "version": "234"
    }
}

//错误时返回JSON数据包(示例为Type无效)
{
    "result": "fail",
    "error_code": 42000,
    "error_info": "非法参数"
}

查看物流

接口地址：

Api/Project/express?order_id=ORDER_ID
请求参数
参数必填说明
order_id是订单ID
返回说明
//正常返回的JSON数据包
{
    "shipping": {
        "traces": [
        ],
        "shipper": "物流单号",
        "tracking_number": "物流公司"
    },
    "result": "ok"
}

//错误时返回JSON数据包(示例为Order_id无效)
{
    "result": "fail",
    "error_code": 41001,
    "error_info": "该订单不存在"
}

图片描述

扫码入群

weixin_34128501
关注
  • 1
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
微信小程序-小程序api适配到标准w3cAPI
08-08
WeApp-adapter 将微信小程序私有的api适配到标准w3c API来开发微信小程序 目标： 让开发者以习惯的标准化的 W3C API来开发微信小程序 让已有的库能够在微信小程序里面使用 使用方法 我们尽量与w3c标准兼容，所以可以像使用标准Websocket接口一样使用adapter var Websocket = require('weapp-adapter').WebSocket var ws = new WebSocket('wss://:') ws.onopen = function(){} ws.addEventListener('open',function(){}) ws.onmessage = function(e){} ws.onclose = function(){} ws.send('hello word')
微信公众平台开发30分钟入门教程
weixin_33958585的博客
10-21 462
在这篇微信公众平台开发教程中，我们假定你已经有了PHP语言程序、MySQL数据库、计算机网络通讯、及HTTP/XML/CSS/JS等基础。 我们将使用微信公众账号方倍工作室作为讲解的例子，二维码见底部。 本系列教程将引导你完成如下任务： 创建新浪云计算平台应用启用微信公众平台开发模式了解数据收发原理及消息格式开发实现微信天气预报功能 第一章 申...
微信小程序开发-拼单神器：含 leanCloud后端案例源码.zip
08-15
微信小程序开发-拼单神器：含 leanCloud后端案例源码.zip
微信小程序开发拼图小游戏
@Grapefruit的博客
01-13 2110
闲来无事，自己用微信小程序开发了一个拼图小游戏玩，大概效果就是这样的： 大概效果就是这样，感兴趣的小伙伴可以看一下，需要代码请留言自己的微信。 ...
微信小程序－拼单神器
03-15
背景  快速连接有共同需求的地域相近的个体，共享商家的一些促销活动（如：满额减、满额起送等），改善高校同学的拼单体验，与身边人一同享受拼单优惠。   项目框架  前端选择是微信小程序，后端是leanCloud。   功能点及完成情况概述 功能点   描述 完成情况 浏览拼单feed流   首页下滑浏览拼单feed流； 下拉加载更多信息 基本完成； 补充：下拉刷新暂未做，暂时未开发API； 查看拼单详情   拼单feed流点击进去可查看拼单详情； 基本完成； 发起拼单（用户侧）   用户发起拼单的入口： ①首页红色“＋”号； ②优惠信息界面，查看优惠信息时，发起拼单； 完成； 补充：由②入口进入
博客微信小程序+ssm后端源码案例设计.zip
04-20
这是一个关于博客微信小程序结合SSM（Spring、SpringMVC、MyBatis）后端源码的案例设计项目。该项目提供了一整套从前端到后端的实现方案，适合学习者进行程序设计实践，特别是对于正在进行毕业设计或者希望提升Web...
weixin051畅阅读微信小程序+ssm后端源码案例设计.zip
04-20
"weixin051畅阅读微信小程序+ssm后端源码案例设计.zip" 这个标题揭示了我们面对的是一个结合微信小程序（WeChat Mini Program）和SSM（Spring、SpringMVC、MyBatis）后端架构的软件开发案例。"畅阅读"可能是这个项目...
高质量阅读微信小程序+ssm后端源码案例设计.zip
04-20
该压缩包文件“高质量阅读微信小程序+ssm后端源码案例设计.zip”提供了一个完整的项目案例，旨在帮助开发者理解并实践微信小程序与SSM（Spring、SpringMVC、MyBatis）后端架构的集成应用。这个案例设计涵盖了前端...
课堂考勤微信微信小程序ssm后端源码案例设计.zip
最新发布
04-21
【标题】"课堂考勤微信小程序SSM后端源码案例设计"是一个针对教育领域开发的项目，旨在实现一个基于微信小程序的课堂考勤系统。SSM是Spring、SpringMVC和MyBatis三个框架的组合，常用于构建Java Web应用。这个案例...
儿童预防接种预约微信小程序+springboot后端源码案例设计.zip
04-20
该压缩包文件“儿童预防接种预约微信小程序+springboot后端源码案例设计.zip”包含了一个完整的项目案例，主要用于儿童预防接种的预约服务。这个项目是通过微信小程序作为前端界面，与基于SpringBoot的后端服务器...
微信小程序-拼单神器
01-27
微信小程序-拼单神器 背景  快速连接有共同需求的地域相近的个体，共享商家的一些促销活动（如：满额减、满额起送等），改善高校同学的拼单体验，与身边人一同享受拼单优惠。 项目框架  前端选择是微信小程序，后端是。 功能点及完成情况概述 功能点 重要程度 描述 完成情况 浏览拼单feed流 首页下滑浏览拼单feed流；下拉加载更多信息 基本完成；补充：下拉刷新暂未做，暂时未开发API； 查看拼单详情 拼单feed流点击进去可查看拼单详情； 基本完成； 发起拼单（用户侧） 用户发起拼单的入口：①首页红色“＋”号；②优惠信息界面，查看优惠信息时，发起拼单； 完成；补充：由②入口进入时，自动填充相关拼单信息； “立即加入”拼单 点击“立即加入”按钮，弹出该拼单的群聊二维码，长按识别二维码加群； 完成；补充：暂时不可识别二维码原因：微信小程序图片是使用background-image，和H5 imag
拼单小程序项目拼单小程序项目
09-25
拼单小项目，数据保存一下。可以下载下来。拼单小项目，数据保存一下。可以下载下来。拼单小项目，数据保存一下。可以下载下来。
微信开发二
王道长的技术博客
12-06 973
一、微信介绍及准备 1.1 微信开发介绍 1.1.1 微信公众号平台介绍 订阅号：偏于为用户传达资讯（类似报纸杂志），认证后每天只可群发一条消息 服务号：给企业和组织提供更强大的业务服务与用户管理能力，帮助企业快速实现全新的公众号服务平台 企业号：为企业提供的移动应用入口。帮助企业建立员工、供应链与企业IT系统间的连接。利用企业号，企业或三方合作伙伴可帮助企业快速、低成本的实现高质量的移动轻应用，实现移动化。企业号作为企业IT 移动化解决方案，比企业自己开发APP有明显优势。适合企业、政府或其他组织。 小程
【技巧】使用微信进行简单的拼接长图
300%努力努力再努力的博客
08-18 473
目的 通过使用多张图片拼接制作长图 操作步骤 我 → 收藏 → 右上角的+ → 添加图片 → 右上角...选择保存为图片 效果图                              &nbsp
Lumen快速入门
weixin_34294649的博客
06-25 688
来源：https://notestore.cn/laravel-... DB类 use Illuminate\Support\Facades\DB; 读取数据库 0~20 条数据 DB::table("?")->where('字段名', 条件值)->where('字段名',条件值)->where('字段名',条件值)-&...
微信小程序拼团后端接口设计规范
weixin_34357436的博客
06-10 853
来源：https://share.notestore.cn/ac... 公告列表 接口地址： g=Api&m=Banner&a=lists 返回说明 //正常返回的JSON数据包 { "result": "ok", "banners": [ { } ] } 商品列表 ...
mysql行号order by_mysql – 从每个GROUP BY(unique_id)和ORDER BY号中选择具有MAX id的行
weixin_32021519的博客
02-02 107
您可以将查询用作子查询：SELECT *FROM tableWHERE id IN (SELECT MAX(id) AS idFROM tableWHERE final=0 AND username='$username' AND active=1GROUP BY unique_id)ORDER BY order_number或者,如果id不唯一,请使用JOIN：SELECT t1.*FROM t...
计算机毕业设计Node.js+Vue基于Vue的社区拼购商城（程序+源码+LW+部署)
node.js毕设小健
02-16 108
该项目含有源码、文档、程序、数据库、配套开发软件、软件安装教程。欢迎交流项目运行环境配置：项目技术：Express框架 + Node.js+ Vue 等等组成，B/S模式 +Vscode管理+前后端分离等等。环境需要1.运行环境：最好是Nodejs最新版，我们在这个版本上开发的。其他版本理论上也可以。2.开发环境：Vscode或HbuilderX都可以。推荐HbuilderX;3.mysql环境：建议是用5.7版本均可4.硬件环境：windows 7/8/10 1G内存以上；
微信小程序权限接口
冲出仁川，走出马德里，故事还会再继续
03-22 4825
微信小程序权限接口1、权限接口1.1 用户授权接口`wx.authorize(Object object)`1.2 获取用户权限设置接口`wx.getSetting(Object object)`1.3 打开用户权限设置接口`wx.openSetting(Object object)`2、授权案例 1、权限接口   部分接口需要经过用户授权统一才能调用。我们把这些接口按使用范围分成多个scope，用户选择对scope进行授权，当授权给一个scope之后，其对应的所有接口都可以直接使用，此类接口调用时： 如
微信小程序怎么与后端接口对接
03-08
微信小程序可以使用 wx.request() 方法向后端接口发送请求，后端接口可以使用 RESTful API 或者其他方式提供数据。在小程序中，可以使用 wx.request() 方法发送 GET、POST、PUT、DELETE 等请求，并且可以设置请求头...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值