ECJiaWiki:Api:cart/list

来自ECJiaWiki
跳转至: 导航搜索

返回上一页

应用场景

 购物车列表页

接口名称

 cart/list

请求参数

字段名 变量名 必填 类型 示例值 描述
token请求凭证 token String 79218f8e710fc755a222de45f43c3fd969b87972 调用接口凭证
店铺id seller_id Int
位置信息 location location字典 位置信息
└ 纬度 longitude String 纬度
└ 经度 latitude String 经度
购物车类型 rec_type string 到家1.30新增 购物车类型(GENERAL_GOODS普通商品,GROUPBUY_GOODS团购商品)

举例如下

{
      "token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
      "seller_id" : 15,
      "location" : {
           "longitude" : "121.4158625918",
           "latitude" : "31.235252261217"
      },
      "rec_type":"GENERAL_GOODS",
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status status字典 {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data data字典 [] 请求接口提供的返回信息
└ 购物车列表 cart_list array() 购物车列表
   └ 附近 local Int 1当前定位范围,0其他地点,1.5新增
   └ 入驻商id seller_id Int 入驻商id
   └ 入驻商名称 seller_name String 入驻商名称
   └ 是否可用 is_disabled Int 1不可用,0可用
   └ 不可用原因 disabled_label String 不在营业时间,超出配送范围
   └ 优惠信息 promotions promotions字典
      └ id id String
      └ 优惠活动名称 title String
      └ 类型 type String cash(现金优惠),discount(打折),gift(赠品)
      └ 类型显示 type_label String 满减,优惠,促销,限时
   └ 产品列表 goods_list Array [] 产品列表
      └ 购物车id rec_id Int 43 购物车id
      └ 商品id goods_id Int 106 商品id
      └ 产品编号 goods_sn String ECS000000 产品编号
      └ 商品名 goods_name Decimal 耳机 商品名
      └ 商品市场售价 market_price String 238.79 商品市场售价
      └ 商品市场售价 formated_market_price String ¥238.79 商品市场售价
      └ 实际价格 goods_price String 199.00
      └ 实际价格 formated_goods_price String ¥199.00
      └ 数量 goods_number Int 1 数量
      └ 小计 subtotal String 小计
      └ 产品属性id goods_attr_id string "3771,3773" 产品属性id
      └ 商品属性 goods_attr array() 商品属性
      └ 属性 attr String "产地:进口[10] \n重量:2kg[30] \n" 属性
      └ 是否选中 is_checked Int 1选中,0未选中
      └ 是否可用 is_disabled Int 1不可用,0可用
      └ 不可用原因 disabled_label String 库存不足,超过上限
      └ 图片信息 img img字典 图片信息
         └ 大缩略图 thumb String 大缩略图
         └ 原图 url String 原图
         └ 小缩略图 small String 小缩略图
      └ 优惠信息 promotions promotions字典
         └ id id String
         └ 优惠活动名称 title String
         └ 类型 type String cash(现金优惠),discount(打折),gift(赠品)
         └ 类型显示 type_label String 满减,优惠,促销,限时
   └ 店铺小计 total total字典 小计
      └ 产品价格 goods_price String ¥98.05 产品价格
      └ 产品价格 unformatted_goods_price String 98.8 产品价格
      └ 市场价格 market_price String ¥108.05 市场价格
      └ 市场价格 unformatted_market_price String 108.8 市场价格
      └ 节省钱数 saving String ¥291.20元 节省钱数(比市场价)
      └ 节约率 save_rate String 17% 节约率
      └ 优惠金额 discount String 91.20 优惠活动优惠金额
      └ 优惠金额格式化 discount_formated String ¥91.20元
      └ 产品总计 goods_amount Int 123 产品总计
      └ 实物总数 real_goods_count Int 2 实物总数
      └ 虚拟物品总数 virtual_goods_count Int 0 虚拟物品总数
└ 小计 total total字典 小计
   └ 产品价格 goods_price String 产品价格
   └ 市场价格 market_price String 市场价格
   └ 节省钱数 saving String ¥291.20元 节省钱数
   └ 节约率 save_rate String 17% 节约率
   └ 产品总计 goods_amount Int 123 产品总计
   └ 实物总数 real_goods_count Int 2 实物总数
   └ 虚拟物品总数 virtual_goods_count Int 0 虚拟物品总数
└ 相关产品 - 单独接口 related_goods Array [] 相关产品

成功举例如下

{
    "data": {
        "cart_list": [
            {
                "local": 1,
                "seller_id": 15,
                "seller_name": "天天果园专营店",
                "is_disabed": 1,
                "disabled_label": "不在营业时间",
                "promotions": [
                    {
                        "id": 325,
                        "title": "全场商品促销,满100打9折",
                        "type": "discount",
                        "type_label": "满折",
                    }
                ]
                "goods_list": [
                    {
                        "rec_id": 4174,
                        "goods_id": 613,
                        "goods_sn": "ECS000613",
                        "goods_name": "意大利多洛米亚充气型天然饮用水(玻璃瓶)330ml",
                        "goods_price": "18.00",
                        "market_price": "21.59",
                        "formated_goods_price": "¥18.00",
                        "formated_market_price": "¥21.59",
                        "goods_number": 1,
                        "subtotal": 18,
                        "attr": "产地:进口[10] \n重量:2kg[30] \n",
                        "goods_attr_id": "3771,3773",
                        "goods_attr": [
                            {
                                "name": "产地",
                                "value": "进口[10] "
                            },
                            {
                                "name": "重量",
                                "value": "2kg[30] "
                            }
                        ],
                        "is_checked": 1,
                        "is_disabed": 1,
                        "disabled_label": "库存不足",
                        "promotions": [
                            {
                                "id": 328,
                                "title": "满9.90、19.90、29.90可换购商品",
                                "type": "discount",
                                "type_label": "换购",
                            }
                        ]
                        "img": {
                            "thumb": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_G_1459106283668.jpg",
                            "url": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/source_img/613_G_1459106283964.jpg",
                            "small": "http://192.168.1.105/ecjia-cityo2o/content/uploads/images/201603/goods_img/613_G_1459106283668.jpg"
                        }
                    }
                ],
                "total": {
                            "goods_price": "¥18.00",
                            "market_price": "¥21.59",
                            "saving": "¥3.59",
                            "save_rate": "17%",
                            "discount": "3.59",
                            "discount_formated": "¥3.59",
                            "goods_amount": 18,
                            "real_goods_count": 1,
                            "virtual_goods_count": 0
                        },
            }
        ],
        "total": {
            "goods_price": "¥18.00",
            "market_price": "¥21.59",
            "saving": "¥3.59",
            "save_rate": "17%",
            "goods_amount": 18,
            "real_goods_count": 1,
            "virtual_goods_count": 0
        },
    },
    "status": {
        "succeed": 1
    }
}

失败举例如下

{
    "status": {
        "succeed": 0,
        "error_code": 100,
        "error_desc": "Invalid session"
    }
}

注:错误编码


传入参数

{
    session:{
      uid: "12",    //用户id
      sid: "d122e3c72332c5af12a71d77c9f1462f5901d276",    //session_id的加密
    }
}

正确的返回参数

{
  data: {
    goods_list: [   //产品列表
      {
        rec_id: "76",   //购物车id
        goods_id: "1",    //产品id
        goods_sn: "ECS000000",    //产品编号
        goods_name: "KD876",    //产品名称
        market_price: "¥1665.60元",    //市场价
        goods_price: "¥1388.00元",   //产品价
        goods_number: "1",    //数量
        goods_attr: "",   //属性
        is_real: "1",     //实物
        extension_code: "",   //延期
        parent_id: "0",   //父级id
        rec_type: "0",    //类型
        is_gift: "0",   //赠品
        is_shipping: "0",   //海运
        can_handsel: "0",   //可以定金
        goods_attr_id: "",    //产品属性id
        pid: "1", 
        subtotal: "¥1388.00元",    //小计
        goods_img: "images/200905/goods_img/1_G_1240902890755.jpg",   //产品图片
        original_img: "images/200905/source_img/1_G_1240902890895.gif",   //原图
        img: {
          thumb: "http://127.0.0.1/myworkEPP/ECShop/upload/images/200905/goods_img/1_G_1240902890755.jpg",    //大缩略图
          url: "http://127.0.0.1/myworkEPP/ECShop/upload/images/200905/source_img/1_G_1240902890895.gif",   //原图
          small: "http://127.0.0.1/myworkEPP/ECShop/upload/images/200905/thumb_img/1_thumb_G_1240902890710.jpg"   //小缩略图
        }
      }
    ],
    total: {    //小计
      goods_price: "¥1456.00元",   //产品价格
      market_price: "¥1747.20元",    //市场价
      saving: "¥291.20元",   //节省钱数
      save_rate: "17%",   //节约率
      goods_amount: 1456,   //产品总计
      real_goods_count: 2,    //实物总数
      virtual_goods_count: 0    //虚拟物品总数
    }
  },
  status: {
    succeed: 1    //成功
  }
}

错误返回参数

{
  status: {		//状态
    succeed: 0;		//是否成功
    error_code: 11;		//错误编码
    error_desc: "用户名或email已使用";		//错误信息
  }
}


注:错误编码