商城接口

我的商城接口文档

  1. baseUrl: http://nideshop.bluej.cn/api/
  2. 默认请求方式为 get,传值类型为字符串
  3. 请求和身份相关的接口时必须设置请求头'X-Nideshop-Token':token,其中token为登陆时获取到
  1. 首屏列表数据

    //url
        index/index
    //data
        {}
    //返回值
    {   errno:0,//错误代码,0表示没有错误,接口调用成功
        errmsg,//错误消息,所有接口意义相同,下文不再赘述
        data:{
       banner:[],//广告位数据
            channel:[],//频道数据
            newGoodsList:[],//新品列表     
            hotGoodsList:[],//热卖列表
            brandList:[],//品牌列表
            topicList:[],//话题列表
            categoryList:[],//分类
        }
    }
    
  2. 分类目录全部分类数据接口

    //url
        catalog/index
    //data
        {}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            "categoryList": [],//分类列表
            "currentCategory": {}//当前分类信息
        }
    }
    
  3. 当前分类数据接口

    //url
        catalog/current
    //data
        { id: id } //当前分类id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  4. 登陆接口

    //url
        auth/loginByWeixin
    //method
        post
    //data
        { code: code, userInfo: userInfo } //传入login的code值以及getuserinfo得到值
    //返回值
    {
        "errno": 0,//表示登陆成功
        "errmsg": "",
        "data": {
           
        }
    }
    
  5. 统计商品总数

    //url
        goods/count
    //data
        {}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  6. 获得商品列表,结合第2个接口用

    //url
        goods/list
    //data
        { categoryId|brandId|keyword|isHot:1|isNew:1, page, size}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            "categoryList": [],//分类列表
            "currentCategory": {}//当前分类信息
        }
    }
    
  7. 获得分类数据

    //url
       goods/category
    //data
       { id } //分类id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  8. 获得商品的详情

    //url
       goods/detail
    //data
      { id } //商品id 
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  9. 新品

    //url
       goods/new
    //data
       { id } //新品id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  10. 热门

    //url
       goods/hot
    //data
       { } 
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  11. 商品详情页的关联商品(大家都在看)

    //url
       goods/related
    //data
       { id } //id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  12. 品牌列表

    //url
       brand/list
    //data
       { page, size }//页数与数量
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  13. 品牌详情

    //url
       brand/detail
    //data
       { id } //id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  14. 获取购物车的数据

    //url
       cart/index
    //data
       {  } 
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  15. 添加商品到购物车

    //url
       cart/add
    //method
        post
    //data
      { goodsId, number, productId }//商品id,数量,产品id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  16. 更新购物车的商品

    //url
       cart/update
    //data
      { goodsId, number, productId }//商品id,数量,产品id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  17. 删除购物车的商品

    //url
       cart/delete
    //method
        post
    //data
      { productIds }//产品id,数据类型为字符串
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  18. 选择或取消选择商品

    //url
       cart/checked
    //data
      { productIds, isChecked }//产品id,多个产品传字符串,产品id之间用逗号隔开;是否选中0未选中,1选中
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  19. 获取购物车商品件数

    //url
       cart/goodscount
    //data
      { }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  20. 下单前信息确认

    //url
       cart/checkout
    //data
      { addressId, couponId }//地址id,优惠券id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  21. 提交订单

    //url
       order/submit
    //data
      { addressId, couponId } //地址id,优惠券id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  22. 获取微信统一下单prepay_id

    //url
       pay/prepay
    //data
       { orderId, payType: 1 } //订单id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  23. 收藏列表

    //url
       collect/list
    //data
      { typeId} //类型id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  24. 添加或取消收藏

    //url
       collect/addordelete
    //method
        post
    //data
      { typeId: 0, valueId} //valueId就是商品id,字符串,typeId不传也可以成功,作用是比如有多个收藏夹时区分
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  25. 评论列表

    //url
      comment/list
    //data
      { 
      valueId, typeId: ,  size, page, showType }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  26. 评论总数

    //url
       comment/count
    //data
      { valueId, typeId} //值id与类型id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  27. 发表评论

    //url
       comment/post
    //method
        post
    //data
      {typeId,valueId,content}//类型id,值id,内容
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  28. 专题列表

    //url
       topic/list
    //data
      { page, size }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  29. 专题详情

    //url
       topic/detail
    //data
      { id}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  30. 相关专题

    //url
       topic/related
    //data
      {{ id}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  31. 搜索页面数据,从这个接口可以获取到搜索关键字,也就是说搜索不能让用户随便输,只能按照这个接口给定的关键字搜索

    //url
       search/index
    //data
      {}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  32. 搜索数据(最近搜索记录,这个接口404)

    //url
       search/result
    //data
      {  }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  33. 搜索帮助

    //url
       search/helper
    //data
      { keyword }//关键字
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  34. 清楚搜索记录

    //url
       search/clearhistory
    //data
      {  }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  35. 收货地址列表

    //url
       address/list
    //data
      {  }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  36. 收货地址详情

    //url
       address/detail
    //data
      { id }//收获地址id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  37. 保存收货地址

    //url
       address/save
    //method
        post
    //data
        /*
        id:地址id,
        name:地址名字,
        mobile:手机,
        province_id:省id,
        city_id:市id,
        district_id:区id,
        address:具体地址,
        is_default:是否默认地址
        */
      {id,name,mobile,province_id, city_id,district_id,address,is_default}
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  38. 删除收获地址

    //url
      address/delete
    //data
      { id }//收获地址id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  39. 获取区域列表

    //url
      region/list
    //data
      { parentId }//市区的爸爸id,其中当parentId=1时,为获取省份列表
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  40. 订单列表

    //url
      order/list
    //data
      {  }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  41. 订单详情

    //url
      order/detail
    //data
      { orderId }//订单id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  42. 取消订单

    //url
      order/cancel
    //data
      { orderId }//订单id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  43. 物流详情

    //url
      order/express
    //data
      { orderId }//订单id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  44. 足迹列表

    //url
      footprint/list
    //data
      { }
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
  45. 删除足迹

    //url
      footprint/delete
    //data
      { footprintId } //足迹id
    //返回值
    {
        "errno": 0,
        "errmsg": "",
        "data": {
            
        }
    }
    
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。