电商 api 接口文档

news2024/11/25 6:56:19

电商 api 接口文档

1、开篇

欢迎使用ShowDoc！

API格式：

备注：电商API必须返回如下3个字段：

参数名必选类型说明
status是int状态
message是string信息提示
result否mix结果

2、用户相关

2.1、登录/退出

简要描述：

  • 用户登录API

请求URL：

  • http://xx.com/api/login

请求方式：

  • POST

参数：

参数名必选类型说明
phone_number是int手机号码
code是int验证码
type类型tinyint1 ：7天 2：30天，默认传递2

返回示例

{
status: 1,
message: "OK",
result: [ ]
}

返回参数说明

简要描述：

  • 用户退出登录接口

请求URL：

  • http://xx.com/api/logout

请求方式：

  • POST GET

  • 备注

  • 更多返回错误代码请看首页的错误代码描述

    备注

  • 更多返回错误代码请看首页的错误代码描述

2.2、发送验证码

简要描述：

  • 获取短信验证码API

请求URL：

  • http://xx.com/api/smscode

请求方式：

  • POST

参数：

参数名必选类型说明
phone_number是int手机号码

返回示例

  {
    "status": 1,
   "message":"发送成功",
   "result":123
  }

返回参数说明

参数名类型说明
statusint状态：1成功， 0失败， -1不能重新发送
messagestring消息提示

备注

  • 更多返回错误代码请看首页的错误代码描述

欢迎使用ShowDoc！

2.3、个人中心

简要描述：

  • 用户个人中心数据

请求URL：

  • http://xx.com/api/user

请求方式：

  • GET

  • 用户个人中心数据

请求URL：

  • http://xx.com/api/user/1

请求方式：

  • PUT

参数：username:用户名 sex: 0:保密， 1男， 2女。

备注

  • 更多返回错误代码请看首页的错误代码描述

3、首页相关

3.1、获取轮播图

简要描述：

  • 获取轮播图

请求URL：

  • http://xx.com/api/index/getRotationChart

请求方式：

  • GET

    返回示例

  {
status: 1,
message: "ok",
result: [
{
id: 1,
title: "abcd",
image: "http://testmall.singwa.com/static/upload/image/1.jpg"
},
{
id: 2,
title: "abcd",
image: "http://testmall.singwa.com/static/upload/image/3.jpg"
},
{
id: 3,
title: "abcd",
image: "http://testmall.singwa.com/static/upload/image/3.jpg"
},
{
id: 4,
title: "abcd",
image: "http://testmall.singwa.com/static/upload/image/5.jpg"
},
{
id: 5,
title: "abcd",
image: "http://testmall.singwa.com/static/upload/image/5.jpg"
}
]
}

点击轮播图跳转到详情页 xxx/api/detail/商品ID

返回示例

备注

  • 更多返回错误代码请看首页的错误代码描述

欢迎使用ShowDoc！

3.2、获取首页栏目推荐的商品

简要描述：

  • 用户注册接口

请求URL：

  • http://xx.com/api/index/cagegoryGoodsRecommend

请求方式： -GET

返回示例

  {
status: 1,
message: "ok",
result: [
{
categorys: {
category_id: 1,
name: "女装",
icon: "",
list: [
{
name: "牛仔裤",
category_id: 2
},
{
name: "短裤",
category_id: 2
},
{
name: "休闲裤",
category_id: 2
},
{
name: "打底裤",
category_id: 2
},
{
name: "丝袜",
category_id: 2
}
]
},
goods: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 2,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 1256.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 4569,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 89.9,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 320.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "8原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 458,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "9原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "10原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 345,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
}
]
},
{
categorys: {
category_id: 2,
name: "电子设备",
icon: "",
list: [
{
name: "电脑",
category_id: 2
},
{
name: "手机",
category_id: 2
},
{
name: "摄像",
category_id: 2
},
{
name: "singwa",
category_id: 2
},
{
name: "abc",
category_id: 2
}
]
},
goods: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 2,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 1256.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 4569,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 89.9,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 320.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "8原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 458,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "9原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "10原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 345,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
}
]
},
{
categorys: {
category_id: 1,
name: "男装",
icon: "",
list: [
{
name: "牛仔裤",
category_id: 2
},
{
name: "短裤",
category_id: 2
},
{
name: "休闲裤",
category_id: 2
},
{
name: "打底裤",
category_id: 2
},
{
name: "丝袜",
category_id: 2
}
]
},
goods: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 2,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 1256.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 4569,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 89.9,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 320.1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "8原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 458,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "9原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 123,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 1,
title: "10原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 345,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
}
]
}
]
}

备注

  • 更多返回错误代码请看首页的错误代码描述

3.3、首页分类

简要描述：

  • 分类接口

请求URL：

  • /api/category

请求方式：

  • GET

参数：

返回示例

 {
status: 1,
message: "OK",
result: [
{
category_id: 51,
name: "男装",
pid: 0,
list: [
{
category_id: 52,
name: "上装",
pid: 51,
list: [
{
category_id: 60,
name: "马甲",
pid: 52
},
{
category_id: 59,
name: "西服",
pid: 52
},
{
category_id: 58,
name: "衬衫",
pid: 52
},
{
category_id: 57,
name: "卫衣",
pid: 52
},
{
category_id: 56,
name: "夹克",
pid: 52
}
]
},
{
category_id: 54,
name: "潮流风向标",
pid: 51,
list: [
{
category_id: 70,
name: "夏装热卖",
pid: 54
},
{
category_id: 69,
name: "玩酷时尚",
pid: 54
},
{
category_id: 68,
name: "雅痞绅潮",
pid: 54
},
{
category_id: 67,
name: "潮男新计",
pid: 54
},
{
category_id: 66,
name: "夏季爆款",
pid: 54
}
]
},
{
category_id: 53,
name: "下装",
pid: 51,
list: [
{
category_id: 65,
name: "哈伦裤",
pid: 53
},
{
category_id: 64,
name: "运动裤",
pid: 53
},
{
category_id: 63,
name: "修身裤装",
pid: 53
},
{
category_id: 62,
name: "休闲裤",
pid: 53
},
{
category_id: 61,
name: "牛仔裤",
pid: 53
}
]
}
]
},
{
category_id: 71,
name: "女装",
pid: 0,
list: [
{
category_id: 74,
name: "女士上装",
pid: 71,
list: [
{
category_id: 78,
name: "衬衫",
pid: 74
},
{
category_id: 77,
name: "卫衣",
pid: 74
},
{
category_id: 76,
name: "毛衣外套",
pid: 74
},
{
category_id: 75,
name: "牛仔外套",
pid: 74
}
]
},
{
category_id: 73,
name: "女士下装",
pid: 71,
list: [
{
category_id: 84,
name: "牛仔裤",
pid: 73
},
{
category_id: 83,
name: "打底裤",
pid: 73
},
{
category_id: 82,
name: "休闲裤",
pid: 73
},
{
category_id: 81,
name: "哈伦裤",
pid: 73
},
{
category_id: 80,
name: "阔腿裤",
pid: 73
}
]
},
{
category_id: 72,
name: "女士裙装",
pid: 71,
list: [
{
category_id: 89,
name: "背带裙",
pid: 72
},
{
category_id: 88,
name: "羊绒连衣裙",
pid: 72
},
{
category_id: 87,
name: "毛呢连衣裙",
pid: 72
},
{
category_id: 86,
name: "针织连衣裙",
pid: 72
},
{
category_id: 85,
name: "蕾丝连衣裙",
pid: 72
}
]
}
]
},
{
category_id: 28,
name: "电脑",
pid: 0,
list: [
{
category_id: 41,
name: "小米",
pid: 28,
list: [
{
category_id: 45,
name: "小米游戏本",
pid: 41
},
{
category_id: 44,
name: "小米Air",
pid: 41
},
{
category_id: 43,
name: "小米Ruby",
pid: 41
},
{
category_id: 42,
name: "RedmiBook",
pid: 41
}
]
},
{
category_id: 40,
name: "戴尔",
pid: 28,
list: [
{
category_id: 47,
name: "DELL游匣",
pid: 40
},
{
category_id: 46,
name: "灵越",
pid: 40
}
]
},
{
category_id: 36,
name: "苹果",
pid: 28,
list: [
{
category_id: 50,
name: "一体机",
pid: 36
},
{
category_id: 49,
name: "mac air",
pid: 36
},
{
category_id: 48,
name: "mac book",
pid: 36
}
]
}
]
},
{
category_id: 26,
name: "手机",
pid: 0,
list: [
{
category_id: 30,
name: "苹果",
pid: 26,
list: [
{
category_id: 33,
name: "iphonexr",
pid: 30
},
{
category_id: 32,
name: "iphonexs max",
pid: 30
},
{
category_id: 31,
name: "iphonexr",
pid: 30
}
]
},
{
category_id: 39,
name: "三星",
pid: 26
},
{
category_id: 38,
name: "华为",
pid: 26
}
]
},
{
category_id: 27,
name: "书",
pid: 0,
list: [
{
category_id: 35,
name: "励志",
pid: 27
},
{
category_id: 34,
name: "计算机",
pid: 27
}
]
}
]
}

4、商品详情相关

4.1、商品详情API

简要描述：

  • 商品详情接口

请求URL：

  • /api/detail/商品ID

请求方式：

  • GET

参数：

返回示例

  {
status: 0,
message: "OK",
result: {
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
cost_price: 20.9,
sales_count: 123,
stock: 8967,  // 库存
gids: {
1,11: 1,
1,12: 5890,
2,11: 4590,
2,12: 890
},
sku: [
{
name: "颜色",
list: [
{
id: 1,
name: "红色",
flag: 1 , // 1高亮
},
{
id: 2,
name: "粉色",
flag: 0
}
]
},
{
name: "尺寸",
list: [
{
id: 11,
name: "L",
flag: 1
},
{
id: 12,
name: "S",
flag: 0
}
]
}
],
detail: {
d1: {
商品编号: "D-8812",
上架时间: "2017-06-24",
商品毛重: "200克",
商品库存: "1000件"
},
d2: "ssss师父父反反复复方法反反复复方法反反复复方法反反复复方法发发发abc"
}
}
}

返回参数说明

当选择sku中内容时候， 比如 1，11 需要去关联提供的gids中的id对应 比如1，11 对应id=1 那 直接重新请求API带上这个新id

备注

  • 更多返回错误代码请看首页的错误代码描述

5、商品列表页面

5.1、按分类检索

简要描述：

  • 分类列表接口

请求URL：

  • http://xx.com/api/category/search/分类ID

请求方式：

  • GET

参数：

返回示例

  {
status: 1,
message: "ok",
result: {
name: "我是一级分类",
focus_ids: [   // 分类的定位焦点 ，注意这个地方 有可能是一个，有可能是两个
1,
11
],
list: [
[
{
id: 1,
name: "二级分类1"
},
{
id: 2,
name: "二级分类2"
},
{
id: 3,
name: "二级分类3"
},
{
id: 4,
name: "二级分类4"
},
{
id: 5,
name: "二级分类5"
}
],
[
{
id: 11,
name: "三级分类1"
},
{
id: 12,
name: "三级分类2"
},
{
id: 13,
name: "三级分类3"
},
{
id: 14,
name: "三级分类4"
},
{
id: 15,
name: "三级分类5"
}
]
]
}
}

  • 更多返回错误代码请看首页的错误代码描述

5.2、sku分类

简要描述：

  • sku接口

请求URL：

  • http://xx.com/api/sku

请求方式：

  • GET

参数：

参数名必选类型说明
category_id是int分类ID

返回示例

  {
status: 1,
message: "ok",
result: [
{
name: "颜色",
list: [
{
id: 1,
name: "红色"
},
{
id: 2,
name: "粉色"
},
{
id: 3,
name: "黄色"
},
{
id: 4,
name: "蓝色"
}
]
},
{
name: "尺寸",
list: [
{
id: 11,
name: "L"
},
{
id: 12,
name: "S"
},
{
id: 13,
name: "M"
},
{
id: 14,
name: "X"
},
{
id: 15,
name: "XL"
},
{
id: 15,
name: "XXL"
}
]
},
{
name: "价格",
list: [
{
id: 21,
name: "0-20"
},
{
id: 22,
name: "20-40"
},
{
id: 23,
name: "40-80"
},
{
id: 24,
name: "100-150"
},
{
id: 25,
name: "150以上"
}
]
}
]
}

  • 更多返回错误代码请看首页的错误代码描述

5.3、商品列表API

简要描述：

  • 商品列表/搜索API

请求URL：

  • http://xx.com/api/lists

请求方式：

  • POST

参数：

参数名必选类型说明
category_id是id分类ID
sku_ids是string1,2,3
price否string10,100 ,如果选择了自定义的价格范围 请传递这个字段
page否int页数，不传递的话默认第一页面
page_size否int每页显示多少条， 默认10条
keyword否sring当是搜索页面的时候 这个字段传递下。
field否sring排序的Key , 价格：price , 销量：sales_count
order否int1: asc , 2:desc

返回示例

  {
status: 1,
message: "ok",
result: {
total_page_num: 10,
count:100
page: 1,
page_size: 10,
list: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
},
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sales_count: 123
}
]
}
}

返回参数说明

参数名类型说明
total_page_numint一共多少页
countint一共多少商品
sales_countint销量

备注

  • 更多返回错误代码请看首页的错误代码描述

5.4、获取子分类

简要描述：

  • 根据分类ID获取子分类

请求URL：

  • /api/subcategory/分类ID

    返回示例

  {
status: 1,
message: "ok",
result: [
{
id: 21,
name: "点二到三分类1"
},
{
id: 22,
name: "点二级三分类2"
},
{
id: 33,
name: "点二到三分类3"
},
{
id: 134,
name: "点二到三分类4"
},
{
id: 154,
name: "点二到三分类5"
}
]
}

返回参数说明

备注

  • 更多返回错误代码请看首页的错误代码描述

5.5、获取搜索关键词

简要描述：

  • 搜索关键词

请求URL：

  • /api/mall.recommend/searchTop

请求方式：

  • GET

参数：

无

返回示例

  {
status: 1,
message: "OK",
result: [
"鞋子",
"iphonexr",
"iphonex max",
"singwa",
"mac book"
]
}

备注

  • 更多返回错误代码请看首页的错误代码描述

5.6、获取推荐商品

简要描述：

  • 获取推荐商品

请求URL：

  • /api/mall.recommend

请求方式：

  • GET

参数：

无

返回示例

  {
status: 1,
message: "OK",
result: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 2,
title: "2原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 3,
title: "3原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 4,
title: "4原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
},
{
id: 5,
title: "5原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg"
}
]
}

  • 更多返回错误代码请看首页的错误代码描述

6、购物车

6.1、添加购物车

简要描述：

  • 添加购物车接口

请求URL：

  • /api/cart/add

请求方式：

  • POST

参数：

参数名必选类型说明
id是int商品具体ID
num是int商品数量

返回示例

  {
    "status": 1,
    "message": "OK",
    "result": []
}

6.2、购物车列表

简要描述：

  • 购物车列表接口

请求URL：

  • /api/cart/lists

请求方式：

  • GET

id = 1,2 如果传递了这个那说明是提交订单之前的页面，比如：如图 图片

返回示例

  {
    "status": 1,
    "message": "OK",
    "result": [
        {
            "id": 1,
            "title": "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
            "price": 12.13,
            "num": 2,
            "image": "http://testmall.singwa666.com/static/upload/image/10.jpg",
            "sku": "颜色：红色 尺码：L"
        },
        {
            "id": 2,
            "title": "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏2",
            "price": 12.13,
            "num": 1,
            "image": "http://testmall.singwa666.com/static/upload/image/10.jpg",
            "sku": "颜色：黄色 尺码：LL"
        }
    ]
}

6.3、删除购物车

简要描述：

  • 添加购物车接口

请求URL：

  • /api/cart/delete

请求方式：

  • POST

参数：

参数名必选类型说明
id是int商品具体ID

返回示例

  {
    "status": 1,
    "message": "OK",
    "result": []
}

6.4、修改购物车数量

简要描述：

  • 修改购物车数量接口

请求URL：

  • http://xx.com/api/cart/update

请求方式：

  • POST

参数：

参数名必选类型说明
id是int购物车ID
num是int数量

7、订单相关

7.1、初始化API

简要描述：

  • 初始化接口

请求URL：

  • http://xx.com/api/api/mall.init

请求方式：

  • POST

参数：

无

返回示例

  {
status: 1,
message: "OK",
result: {
cart_num: 12
}
}

7.2、获取用户地址信息

简要描述：

  • 地址信息接口

请求URL：

  • http://xx.com/api/address

请求方式：

  • GET

参数： 无

返回示例

  {
status: 1,
message: "OK",
result: [
{
id: 1,
consignee_info: "江西省 上饶市 鄱阳县xxx 王新华收 180xxxx",
is_default: 1
},
{
id: 2,
consignee_info: "2江西省 上饶市 鄱阳县xxx 王新华收 180xxxx",
is_default: 0
},
{
id: 3,
consignee_info: "3江西省 上饶市 鄱阳县xxx 王新华收 180xxxx",
is_default: 0
}
]
}

返回参数说明

参数名类型说明
idintid
consignee_infostring地址基本信息
is_defaultint1:默认地址， 0：不是默认

备注

  • 更多返回错误代码请看首页的错误代码描述

7.3、提交订单

简要描述：

  • 提交订单接口

请求URL：

  • http://xx.com/api/order

请求方式：

  • POST

参数：

参数名必选类型说明
address_id是int地址ID
cart_ids是string购物车id: 如1,2,3

返回示例

  {
    "status": 1,
    "message": "OK",
    "result": {
        "id": 108940795062
    }
}

备注

  • 更多返回错误代码请看首页的错误代码描述

7.4、获取订单信息

简要描述：

  • 获取订单接口

请求URL：

  • http://xx.com/api/order/订单ID

请求方式：

  • GET

参数：

返回示例

{
status: 1,
message: "OK",
result: {
id: 108940795062,
price: 123.34,
consignee_info: "江西省 上饶市 鄱阳县xxx 王新华收 180xxxx",
create_time: "2020-01-20:12:34:67",
pay_time: "2020-01-20:12:35:67",
mall_title: "桂花树苗 嫁接桂花苗盆栽四季桂金桂浓香型庭院室内植物盆景室内阳台种植 白玉藤紫藤苗 三年苗,御春阁 火棘盆景下山桩火棘树桩冬天结果植物 庭院盆栽绿化",
malls: [
{
id: 1,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏",
price: 12.13,
num: 2,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sku: "颜色：红色 尺码：L"
},
{
id: 2,
title: "原创设计日常汉服女款绣花长褙子吊带改良宋裤春夏2",
price: 12.13,
num: 1,
image: "http://testmall.singwa666.com/static/upload/image/10.jpg",
sku: "颜色：黄色 尺码：LL"
}
]
}

7.5、订单列表

简要描述：

  • 订单列表接口

请求URL：

  • http://xx.com/api/order

请求方式：

  • GET

    参数说明

参数名类型说明
typeint1待支付2待发货3待收货4已完成5已取消

返回示例

  {
status: 1,
message: "OK",
result: {
total_page_num: 1,
count: 4,
page: 1,
page_size: 10,
list: [
{
id: 123456,
cart_ids: "1,2",
create_time: "2020-01-20",
mall_title: "桂花树苗;嫁接桂花苗盆栽四季桂金桂浓香型庭院室内植物盆景室内阳台种植;白玉藤紫藤苗",
count: 3,
unit_price: "100,10,20.4",
price: "130.4",
type: 1,
type_name: "已完成"
},
{
id: 1234516,
cart_ids: "1",
create_time: "2020-01-20",
mall_title: "我就一个商品哦。",
count: 1,
unit_price: "100",
price: "100",
pay_status: 0,
type: 2,
type_name: "待支付"
},
{
id: 1234516,
cart_ids: "2",
create_time: "2020-01-20",
mall_title: "我就一个商品，但是我买了两件",
count: 2,
unit_price: "10",
price: "20",
type: 3,
type_name: "待发货"
},
{
id: 1234516,
cart_ids: "1,2",
create_time: "2020-01-20",
mall_title: "3桂花树苗;嫁接桂花苗盆栽四季桂金桂浓香型庭院室内植物盆景室内阳台种植;白玉藤紫藤苗",
count: 4,
unit_price: "100,10,20.4",
price: "130.4",
type: 4,
type_name: "待收货"
}
]
}
}
备注参数名类型说明
idint订单号
create_timeint订单创建时间
mall_titlestring商品标题
countint商品数量
unit_priceint单价
priceint总价

  • 更多返回错误代码请看首页的错误代码描述

7.6、取消/删除订单

简要描述：

  • 取消订单接口

请求URL：

  • http://xx.com/api/order/订单ID

请求方式：

  • PUT

参数：

参数名必选类型说明
type是int5 取消订单, 99:删除订单

8、支付

8.1、页面异步回调订单支付状态

简要描述：

请求URL：

  • http://xx.com/api/order.async/queryState

请求方式：

  • POST

参数：

参数名必选类型说明
order_id是int订单ID

返回示例

  {
status: 1,
message: "OK",
result: {
pay_status: 1
}
}

返回参数说明

参数名类型说明
pay_statusint订单状态，1：支付成功；0 ：未支付

备注

  • 更多返回错误代码请看首页的错误代码描述

8.2、支付

简要描述：

请求URL：

  • http://xx.com/api/pay

请求方式：

  • POST

参数：

参数名必选类型说明
order_id是int订单号
pay_type是string支付类型：alipay:支付宝 , weixin:微信支付

 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/765983.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

【复盘】记录一次类型不一致导致的Kafka消费异常问题

【复盘】记录一次类型不一致导致的Kafka消费异常问题

背景 业务主要是通过A系统向B系统写入Kafka，然后B系统消费Kafka 将结果写到Kafka中，A进行消费最终结果。 在整个流程中，A写入Kafka会写入一张 record1表记录，然后在A消费最终结果的时候也记录一张record2表。主要改动的话 只是B系…
阅读更多...
从Web2到Web3：区块链技术的未来前景

从Web2到Web3：区块链技术的未来前景

随着互联网的发展，Web1.0、Web2.0 和 Web3.0 成为了人们口中津津乐道的话题。那么，这三种网络时代究竟有什么区别呢？ Web1.0 是一个只读的时代，那个时候，用户只能浏览网页，无法进行互动和创作。Web2.0 则是…
阅读更多...
什么是社会智商？24种人格力量之社会智商的力量

什么是社会智商？24种人格力量之社会智商的力量

什么是社会智商？ 社会智商指的是将人的智力具体化，自己对他人的了解以及自我剖析能力的高低。一般而言，社会智商越高，对他人的观测能力越高，自我剖析就越透彻。社会智商来源于via 24种人格力量，是人格的优…
阅读更多...
FPGA实现UART协议的接收与发送

FPGA实现UART协议的接收与发送

一、接收模块uart_rx.v UART协议，空闲时，TX和RX数据线都是通过上拉电阻拉高的状态，这样才能在起始位到来时检测到一个下降的边沿。 UART数据格式 uart_rx.v模块输入输出示意图 RX_start。首先，找到起始位的开始时刻RX_start&…
阅读更多...
在程序员从业生涯中，哪本书让你醍醐灌顶？

在程序员从业生涯中，哪本书让你醍醐灌顶？

推荐《程序员的README》 [美] 克里斯里科米尼（Chris Riccomini） 著，付裕 译 每名新入行的工程师在开始工作之前要阅读的书！10年大型公司初级工程师指导经验的行业大咖教你如何开启职业生涯、扩展工作技能、应对糟糕管理&#xff0…
阅读更多...
信音电子在创业板IPO：募资约9亿元，预计上半年收入约4.3亿元

信音电子在创业板IPO：募资约9亿元，预计上半年收入约4.3亿元

7月17日，信音电子（中国）股份有限公司（下称“信音电子”，SZ:301329）在深圳证券交易所创业板上市。本次上市，信音电子的发行价为21.00元/股，发行数量为为4300万股，募资总额…
阅读更多...
Java 压缩多个文件为zip包（中间不生成临时文件，直接压缩为zip二进制流），以及解压zip包二进制流为文件

Java 压缩多个文件为zip包（中间不生成临时文件，直接压缩为zip二进制流），以及解压zip包二进制流为文件

Java 压缩多个文件为zip包及解压zip包以及压缩多文件为zip文件流解压zip二进制流（中间不生成临时文件，直接压缩为zip二进制流，并验证解压） 1. 效果图2. 源码 这篇博客将提供俩种方法， 提前生成要压缩的多个文件&#…
阅读更多...
vscode debug的方式

vscode debug的方式

在.vscode文件夹下建立launch.json 例子1：调试python 来自 https://github.com/chunleili/tiPBD/tree/amg {"version": "0.2.0","configurations": [{"name": "hpbd 5 5","type": "python&quo…
阅读更多...
港联证券|通胀和通缩的区别？通胀对股市有什么影响？

港联证券|通胀和通缩的区别？通胀对股市有什么影响？

在市场经济上，通货紧缩和通货膨胀是两种比较常见的两种经济现象，那么，通胀和通缩的差异？通胀对股市有什么影响？ 港联证证券为大家预备了相关内容，以供参考。 通胀和通缩存在以下差异： 1、定义…
阅读更多...
初识操作系统

初识操作系统

操作系统 文章目录 操作系统一、上次的问题二、什么是操作系统(Operator System）设计操作系统的目的 三、操作系统上下层分别是什么四、先描述，后组织 一、上次的问题 为什么程序运行之前必须先加载到内存？ 因为可执行程序（文件…
阅读更多...
数字化时代，如何做好用户体验与应用性能管理​

数字化时代，如何做好用户体验与应用性能管理​

引言 随着数字化时代的到来，各个行业的应用系统从传统私有化部署逐渐转向公有云、行业云、微服务，这种变迁给运维部门和应用部门均带来了较大的挑战。基于当前企业 IT 运维均为多部门负责，且使用多种运维工具，因此，当…
阅读更多...
【27】SCI易中期刊推荐——计算机科学机器人学（中科院2区）

【27】SCI易中期刊推荐——计算机科学机器人学（中科院2区）

💖💖>>>加勒比海带,QQ2479200884<<<💖💖 🍀🍀>>>【YOLO魔法搭配&论文投稿咨询】<<<🍀🍀 ✨✨>>>学习交流 | 温澜潮生 | 合作共赢 | 共同进步<<<✨✨ 📚📚>>>人工智能 | 计算机视觉…
阅读更多...
arcgis建筑密度容积率覆盖率

arcgis建筑密度容积率覆盖率

大多数研究会把覆盖率当作建筑密度。 用覆盖率更恰当一些。 建筑覆盖率&#xff1a; 建筑物占据面积/街区面积 [Sum_area]/ ([area]*1000000) 排序检查数据&#xff0c;最大值0.75&#xff0c;最小值0. 建筑覆盖率&#xff0c;建筑密度的范围都应该在0-1之内&#xff0c;不是…
阅读更多...
linux之Ubuntu系列（三）远程管理指令☞SSH 高级应用 RSA非对称加密 以及免密登录，配置别名

linux之Ubuntu系列（三）远程管理指令☞SSH 高级应用 RSA非对称加密 以及免密登录，配置别名

对称加密 、非对称加密 1、对称加密中加密和解密使用的秘钥是同一个&#xff1b;非对称加密中采用两个密钥&#xff0c;一般使用公钥进行加密&#xff0c;私钥进行解密。 2、对称加密解密的速度比较快&#xff0c;非对称加密和解密花费的时间长、速度相对较慢。 3、对称加密的…
阅读更多...
【文末送书】AIGC时代的数据分析与可视化

【文末送书】AIGC时代的数据分析与可视化

欢迎关注博主 Mindtechnist 或加入【智能科技社区】一起学习和分享Linux、C、C、Python、Matlab&#xff0c;机器人运动控制、多机器人协作&#xff0c;智能优化算法&#xff0c;滤波估计、多传感器信息融合&#xff0c;机器学习&#xff0c;人工智能等相关领域的知识和技术。搜…
阅读更多...
C语言实现：offsetof(OFFSETOF)宏的实现

C语言实现：offsetof(OFFSETOF)宏的实现

C语言实现&#xff1a;offsetof宏的实现 offsetof:求结构体成员的偏移量 offsetof:求结构体成员的偏移量 直接上代码&#xff1a; #define OFFSETOF(type,member) ((size_t)(&(((type*)0)->member))) 图解&#xff1a; 图中测试原码&#xff1a; #include<stdi…
阅读更多...
Centos Stream9安装vim代码提示coc的详细过程

Centos Stream9安装vim代码提示coc的详细过程

Centos Stream9安装vim代码提示coc的安装步骤&#xff1a; 1、安装字体 https://github.com/ryanoasis/nerd-fonts/releaseshttps://github.com/ryanoasis/nerd-fonts/releases wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.0.2/Hack.tar.xz 下载后&a…
阅读更多...
短视频seo抖音矩阵源码开发搭建技术解析

短视频seo抖音矩阵源码开发搭建技术解析

一、 短视频seo抖音矩阵源码开发需要考虑以下几个方面&#xff1a; 技术选型&#xff1a;选择合适的开发语言、框架和数据库&#xff0c;常用的开发语言有Java、PHP等&#xff0c;常用的框架有Spring、Django等&#xff0c;常用的数据库有MySQL、MongoDB等。 服务器的选择&…
阅读更多...
若依框架系列教程（RuoYi-Vue前后端分离版本）

若依框架系列教程（RuoYi-Vue前后端分离版本）

视频教程见评论 相关文档&#xff1a; https://www.cnblogs.com/52mqq/p/16068330.html 若依 Ruo-Yi&#xff08;分离版&#xff09;学习笔记 若依框架RuoYi项目运行启动教程【傻瓜式教程】_若依前端怎么启动_紫陌~的博客-CSDN博客 一定要看上面那个傻瓜式教程&#xff0c;…
阅读更多...
MediaType的常用类型-GPT问答

MediaType的常用类型-GPT问答

MediaType的常用类型-GPT问答 MediaType是一个枚举类&#xff0c;包含了常见的媒体类型。下面是一些常用的MediaType类型&#xff1a; APPLICATION_JSON&#xff1a;JSON格式的数据APPLICATION_XML&#xff1a;XML格式的数据APPLICATION_FORM_URLENCODED&#xff1a;表单格式的…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023