【v5】微信小程序拼团后端接口设计规范
文章目录
概要
来源:https://pinapp.gitee.io/w5/api/
基于拼团后端接口简约的特点,我们拟定了后端小程序拼团接口设计指南和建议。
适合 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=TOKENHTTP请求方式:
POSTPOST参数说明:
| 参数 | 必填 | 说明 |
|---|---|---|
| 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=TOKENHTTP请求方式:
PUTPUT参数说明:
| 参数 | 必填 | 说明 |
|---|---|---|
| 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_IDHTTP请求方式:
PUTPUT参数说明:
| 参数 | 必填 | 说明 |
|---|---|---|
| status | 是 | DEFAULT |
示例:
{
"status": "DEFAULT"
}返回说明
//正常返回的JSON数据包
{
"result": "ok"
}删除地址
接口地址:(TOKEN 需换成登陆令牌 / ADDRESS_ID 需换成地址ID)
Api/Weuser/address?address_id=ADDRESS_ID&token=TOKENHTTP请求方式:
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=TOKENHTTP请求方式:
PUTPUT参数说明:
| 参数 | 必填 | 说明 |
|---|---|---|
| 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": "该订单不存在"
}
扫码入群

评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论