接口文档v2.1
请求参数:
公共参数:token、source=android、appVersion
返回数据:
code:0为成功,1为失败,2为token过期
msg:提示消息(可根据项目需求处理逻辑)
1.登录接口
接口地址:https://www.zhaoapi.cn/user/login
返回格式:json
请求方式:get/post
接口备注:用户登录接口
请求参数说明:
名称 | 类型 | 必填 | 说明 |
mobile | string | 是 | 手机号 |
password | string | 是 | 密码 |
token | string | 否 | 用户令牌 |
2.注册接口
接口地址:https://www.zhaoapi.cn/user/reg
返回格式:json
请求方式:get/post
接口备注:用户注册接口
请求参数说明:
名称 | 类型 | 必填 | 说明 |
mobile | string | 是 | 手机号 |
password | string | 是 | 密码 |
token | String | 否 | 用户令牌 |
3.上传头像
接口地址:https://www.zhaoapi.cn/file/upload
返回格式:json
请求方式:get/post
接口备注:上传头像接口(file路径修改)
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
file | File | 是 | 文件 |
token | String | 否 | 用户令牌 |
4.获取用户信息
接口地址:https://www.zhaoapi.cn/user/getUserInfo
返回格式:json
请求方式:get/post
接口备注:用户信息接口
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
token | String | 是 | 用户令牌 |
5.首页广告(轮播图+京东秒杀+最底部的为你推荐)
接口地址:https://www.zhaoapi.cn/ad/getAd
返回格式:json
请求方式:get/post
接口备注:首页轮播图广告,京东秒杀,为你推荐
请求参数说明:
名称 | 类型 | 必填 | 说明 |
token | String | 否 | 用户令牌 |
返回参数说明
type:0 跳转到活动页
type:1 跳转到商品详情页
6.商品分类接口(此接口用于首页九宫格,和底部页签分类页)
接口地址:https://www.zhaoapi.cn/product/getCatagory
返回格式:json
请求方式:get/post
接口备注:商品分类接口
请求参数说明:
名称 | 类型 | 必填 | 说明 |
token | String | 否 | 用户令牌 |
返回参数说明
ishome:1 首页显示分类九宫格
ishome:0 首页不显示
7.商品子分类接口
接口地址:https://www.zhaoapi.cn/product/getProductCatagory
返回格式:json
请求方式:get/post
接口备注:商品子分类接口
请求参数说明:
名称 | 类型 | 必填 | 说明 |
cid | string | 是 | 主分类id |
token | String | 否 | 用户令牌 |
返回参数说明
参考返回json串
8.商品详情
接口地址:https://www.zhaoapi.cn/product/getProductDetail
返回格式:json
请求方式:get/post
接口备注:商品详情
请求参数说明:
名称 | 类型 | 必填 | 说明 |
pid | string | 是 | 商品id |
token | String | 否 | 用户令牌 |
返回参数说明
参考返回json串
images:顶部图片列表
detailUrl:上拉加载详情的h5页面
subhead:副标题
9.当前子分类下的商品列表(分页)
接口地址:https://www.zhaoapi.cn/product/getProducts
返回格式:json
请求方式:get/post
接口备注:当前子分类下的商品列表
请求参数说明:
名称 | 类型 | 必填 | 说明 |
pscid | string | 是 | 商品子分类id |
page | String | 否 | 页码1,2,3 |
sort | string | 否 | 排序: 0:默认 1:销量 2:价格 |
token | String | 否 | 用户令牌 |
返回参数说明
参考返回json串
返回商品列表
10.根据关键词搜索商品
接口地址:https://www.zhaoapi.cn/product/searchProducts?keywords=笔记本&page=1
返回格式:json
请求方式:get/post
接口备注:获取默认收货地址
请求参数说明:
名称 | 类型 | 必填 | 说明 |
keywords | string | 是 | 搜索关键词 |
page | string | 否 | 页码:默认为1 |
sort | string | 否 | 排序: 0:默认 1:销量 2:价格 |
token | String | 否 | 用户令牌 |
11.修改昵称
接口地址:https://www.zhaoapi.cn/user/updateNickName
返回格式:json
请求方式:get/post
接口备注:修改昵称
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
nickname | string | 是 | 用户昵称 |
token | String | 是 | 用户令牌 |
返回参数说明
12.添加购物车
接口地址:https://www.zhaoapi.cn/product/addCart
返回格式:json
请求方式:get/post
接口备注:添加购物车(删除sellerid字段)
请求参数说明:
名称 | 类型 | 必填 | 说明 |
Uid | string | 是 | 用户id |
Pid | string | 是 | 商品id |
Token | String | 是 | 用户令牌 |
返回参数说明
13.查询购物车
接口地址:https://www.zhaoapi.cn/product/getCarts
返回格式:json
请求方式:get/post
接口备注:查询购物车
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
token | String | 是 | 用户令牌 |
返回参数说明
14.更新购物车
返回格式:json
请求方式:get/post
接口备注:更新购物车
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
sellerid | string | 是 | 商户id |
pid | string | 是 | 商品id |
num | string | 是 | 商品数量 |
selected | string | 是 | 是否选中 0 未选中 1已选中 |
token | String | 是 | 用户令牌 |
返回参数说明
15.删除购物车(新增)
返回格式:json
请求方式:get/post
接口备注:删除购物车
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
pid | string | 是 | 商品id |
token | String | 是 | 用户令牌 |
返回参数说明
15.修改订单状态
接口地址:https://www.zhaoapi.cn/product/updateOrder?uid=71&status=1&orderId=1
返回格式:json
请求方式:get/post
接口备注:修改订单状态
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
status | string | 是 | 订单状态: 0 待支付 1 已支付 2 已取消 |
orderId | string | 是 | 订单id |
token | String | 是 | 用户令牌 |
返回参数说明
16.创建订单(为了开发方便,只做简单功能)
返回格式:json
请求方式:get/post
接口备注:创建订单
请求参数说明:
名称 | 类型 | 必填 | 说明 |
Uid | string | 是 | 用户id |
Price | string | 是 | 实付价格 |
Token | String | 是 | 用户令牌 |
返回参数说明
17.订单列表
接口地址:https://www.zhaoapi.cn/product/getOrders?uid=71
返回格式:json
请求方式:get/post
接口备注:订单列表
请求参数说明:
名称 | 类型 | 必填 | 说明 |
Uid | string | 是 | 用户id |
Page | string | 否 | 页码1,2,3 |
Token | String | 是 | 用户令牌 |
返回参数说明
18.常用收货地址列表
接口地址:https://www.zhaoapi.cn/user/getAddrs?uid=71
返回格式:json
请求方式:get/post
接口备注:常用地址列表
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
token | String | 是 | 用户令牌 |
返回参数说明
19.添加常用收获地址
返回格式:json
请求方式:get/post
接口备注:添加常用地址
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
addr | string | 是 | 详细地址 |
mobile | string | 是 | 手机号 |
name | string | 是 | 姓名 |
token | String | 是 | 用户令牌 |
返回参数说明
20.修改常用收货地址
返回格式:json
请求方式:get/post
接口备注:修改常用地址
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
addrid | string | 是 | 地址id |
mobile | string | 否 | 手机号 |
name | string | 否 | 姓名 |
token | String | 是 | 用户令牌 |
21.设置默认地址
返回格式:json
请求方式:get/post
接口备注:设为默认地址
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
addrid | string | 是 | 地址id |
status | string | 是 | 默认状态: 0:非默认 1:默认 此处传1 |
token | String | 是 | 用户令牌 |
22.获取默认地址
接口地址:https://www.zhaoapi.cn/user/getDefaultAddr?uid=71
返回格式:json
请求方式:get/post
接口备注:获取默认收货地址
请求参数说明:
名称 | 类型 | 必填 | 说明 |
uid | string | 是 | 用户id |
token | String | 是 | 用户令牌 |