黑马商城

Base URLs:

• 开发环境: http://localhost:8080

接口文档

POST 登录接口

POST /users/login

Body 请求参数

{
  "username": "jack",
  "password": "123456"
}

请求参数

名称	位置	类型	必选	中文名	说明
body	body	object	否		none
» username	body	string	是	用户名	none
» password	body	string	是	密码	none

返回示例

成功

{
  "token": "this is jiade data",
  "userId": "1",
  "username": "Jack",
  "balance": 844000
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» token	string	true	none	令牌	none
» userId	string	true	none	用户id	none
» username	string	true	none	用户名	none
» balance	integer	true	none	是否记住密码	none

GET 商品检索

GET /search/list

请求参数

名称	位置	类型	必选	中文名	说明
key	query	string	否		检索词
pageNo	query	integer	否		当前页
pageSize	query	integer	否		每页条数
sortBy	query	string	否		排序字段
isAsc	query	string	否		排序
brand	query	string	否		品牌
category	query	string	否		分类

返回示例

成功

{
  "total": "10230",
  "pages": "512",
  "list": [
    {
      "id": "100002624512",
      "name": "【千玺代言】华为新品 HUAWEI nova 4 极点全面屏手机 2000万超广角三摄 8GB+128GB 蜜语红 全网通双卡双待",
      "price": 90600,
      "stock": 9995,
      "image": "https://m.360buyimg.com/mobilecms/s720x720_jfs/t1/20085/14/1076/149604/5c0f8dd2Ebafd3bfd/0cb34a7826cbe1c3.jpg!q70.jpg.webp",
      "category": "手机",
      "brand": "华为",
      "spec": "{\"颜色\": \"红色\"}",
      "sold": 0,
      "commentCount": 0,
      "isAD": false,
      "status": 1,
      "createTime": "2019-05-01T00:00:00",
      "updateTime": "2024-06-20T15:29:58",
      "creater": null,
      "updater": null
    },
    {
      "id": "100001964366",
      "name": "OPPO A7 全面屏拍照手机 4GB+64GB 清新粉 全网通 移动联通电信4G 双卡双待手机",
      "price": 65400,
      "stock": 9997,
      "image": "https://m.360buyimg.com/mobilecms/s720x720_jfs/t25564/327/2615611632/135559/d3c69840/5bebd32eN3bf6f987.jpg!q70.jpg.webp",
      "category": "手机",
      "brand": "OPPO",
      "spec": "{\"颜色\": \"粉色\"}",
      "sold": 0,
      "commentCount": 0,
      "isAD": false,
      "status": 1,
      "createTime": "2019-05-01T00:00:00",
      "updateTime": "2024-06-11T23:36:19",
      "creater": null,
      "updater": null
    }
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» total	string	true	none		总共条数
» pages	string	true	none		总页数
» list	[object]	true	none		none
»» id	string	true	none		主键
»» name	string	true	none		名字
»» price	integer	true	none		价格
»» stock	integer	true	none		库存
»» image	string	true	none		图片
»» category	string	true	none		分类
»» brand	string	true	none		品牌
»» spec	string	true	none		规格
»» sold	integer	true	none		销量
»» commentCount	integer	true	none		评论数
»» isAD	boolean	true	none		广告推广
»» status	integer	true	none		状态
»» createTime	string	true	none		创建时间
»» updateTime	string	true	none		修改时间
»» creater	null	true	none		创建者
»» updater	null	true	none		修改者