电商 api 接口文档

1、开篇

欢迎使用ShowDoc!

API格式:

备注:API必须返回如下3个字段:

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

2、用户相关

2.1、登录/退出

简要描述:

请求URL:

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

请求方式:

  • POST

参数:

参数名 必选 类型 说明
phone_number int 手机号码
code int 验证码
type 类型 tinyint 1 :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
  }

返回参数说明

参数名 类型 说明
status int 状态:1成功, 0失败, -1不能重新发送
message string 消息提示

备注

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

欢迎使用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

请求方式:

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

返回示例

备注

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

欢迎使用ShowDoc!

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

简要描述:

  • 用户注册接口

请求URL:

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

请求方式: -GET

返回示例

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 类型 tinyint 1 :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
  }

返回参数说明

参数名 类型 说明
status int 状态:1成功, 0失败, -1不能重新发送
message string 消息提示

备注

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

欢迎使用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

请求方式:

点击轮播图跳转到详情页 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"
}
]
},
{

  {
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"
}
]
},
{
相关推荐
我不要放纵4 分钟前
LVS集群搭建
linux·服务器·lvs
Struggler2817 分钟前
Chrome插件开发
前端
阿巴~阿巴~8 分钟前
自主Shell命令行解释器
linux·运维·服务器
apihz15 分钟前
域名WHOIS信息查询免费API使用指南
android·开发语言·数据库·网络协议·tcp/ip
前端 贾公子20 分钟前
Monorepo + vite 怎么热更新
前端
gwcgwcjava21 分钟前
[时序数据库-iotdb]时序数据库iotdb的安装部署
数据库·时序数据库·iotdb
SHUIPING_YANG35 分钟前
根据用户id自动切换表查询
java·服务器·数据库
爱吃烤鸡翅的酸菜鱼1 小时前
IDEA高效开发:Database Navigator插件安装与核心使用指南
java·开发语言·数据库·编辑器·intellij-idea·database
超奇电子1 小时前
阿里云OSS预签名URL上传与临时凭证上传的技术对比分析
数据库·阿里云·云计算
chao_7891 小时前
更灵活方便的初始化、清除方法——fixture【pytest】
服务器·自动化测试·python·pytest