ECJiaWiki:Api:Seller/list

来自ECJiaWiki
跳转至: 导航搜索

返回上一页

应用场景

 获取店铺街店铺列表,可根据店铺分类进行查询

接口名称

 seller/list

请求参数

字段名 变量名 必填 类型 示例值 描述
城市id city_id string 城市id(为地区时传地区id)
经纬度信息 location location字典 经纬度信息
└ 纬度 longitude String 纬度
└ 经度 latitude String 经度
分页请求数据 pagination 字典 分页请求参数,包括当前页和每页显示的条数
└ 分页请求数据(每页显示的条数) count Int 10 分页请求数据(每页显示的条数)
└ 分页请求数据(当前显示页) page Int 1 分页请求数据(当前显示页)
店铺街的分类 category_id Int 10(可不传,不传获取全部店铺信息) 店铺街的分类
关键字 keywords string 关键字
不需要商品,优惠活动,买单活动 no_needs string 到家1.16新增 不需要商品,优惠活动,买单活动(goods,favourable,quickpay)默认返这些

举例如下

"token" : "d122e3c72332c5af12a71d77c9f1462f5901d276",
"pagination" : {
      "count" : 10,		
      "page"  : 1 		
},
"category_id" : 25,

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态码 status 字典 {"succeed" : 1} 返回请求接口后的数据,succeed为1代表成功,0则为失败,失败后则返回error_code(错误code)及error_desc(错误说明)
返回信息 data 字典 请求接口提供的返回信息
店铺街店铺id id Int 店铺街店铺id
店铺街店铺名称 seller_name String 店铺街店铺名称
店铺街店铺logo图 seller_logo String 店铺街店铺logo图
店铺公告 seller_notice String
店铺分类 seller_category String 店铺分类
店铺经营模式 manage_mode String 店铺经营模式(self:自营,join:商家)
店铺商品列表 seller_goods Array() 店铺商品列表
└ 商品id goods_id Int 商品id
└ 商品名称 name String 商品名称
└ 商品市场价格 market_price String 商品市场价格
└ 商品本店价格 shop_price String 商品本店价格
└ 商品促销价格 promote_price String 商品促销价格
└ 商品图片信息 img 字典 商品图片信息
   └ 商品图片信息 thumb String 商品图片信息
   └ 商品图片信息 url String 商品图片信息
   └ 商品图片信息 small String 商品图片信息
└ 商品类型 activity_type String 商品类型(普通商品:GENERAL_GOODS)
└ 省多少钱 saving_price String 省多少钱
└ 省多少钱(格式化) formatted_saving_price String 省多少钱(格式化)
└ 关注人数 follower Int 关注人数
└ 店铺是否打烊 shop_closed int 到家1.16新增 店铺是否打烊(0否1是)
└ 是否关注 is_follower Int 是否关注
└ 商品总数 goods_count Int 商品总数
└ 优惠活动列表 favourable_list Array() 优惠活动列表
   └ 优惠活动名称 name String 优惠活动名称
   └ 优惠活动类型 type String 优惠活动类型
   └ 优惠活动类型(格式化) type_label String 优惠活动类型(格式化)
└ 买单活动是否开启 allow_use_quickpay int 到家1.14时新增 买单活动是否开启(0否1是)
└ 闪惠活动列表 quickpay_activity_list Array() 到家1.8时新增 闪惠活动列表
   └ 闪惠活动id activity_id int 闪惠活动id
   └ 闪惠活动名称 title String 闪惠活动名称
   └ 活动类型 activity_type string 活动类型
   └活动类型(中文) label_activity_type string 活动类型
   └限制时间类型 limit_time_type string 限制时间类型(nolimit不限制时间, customize自定义时间)
   └每周限星期 limit_time_weekly string 每周限星期
   └每天限时间段 limit_time_daily string 每天限时间段
   └活动不可用日期 limit_time_exclude string 活动不可用日期
   └闪惠活动订单总数 total_order_count int 闪惠活动订单总数
└ 距当前店铺的距离 distance Int 距当前店铺的距离

成功举例如下

{
      "data" : {
            "id" : "5",
            "seller_name" : "昊天影碟专卖店",
            "seller_category" : "图书音像",
            "seller_logo" : "http://test.b2b2c.ecjia.com/content/uploads/data/merchant/2015-08/47/1440530239440944182.png",
            "seller_notice" : "店铺公告",
            "manage_mode" : "self",
            "seller_goods": [{
                  "id" : 1,
                  "name" : "张学友 2014全新大碟:醒着做梦(CD)",
                  "market_price" : "¥52.80",
                  "shop_price" : "¥44.00",
                  "promote_price" : "",
                  "img": {
                        "thumb" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/goods_img/430_G_1441150995685.png",
                        "url" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/source_img/430_G_1441150995761.png",
                        "small" : "http://test.b2b2c.ecjia.com/content/uploads/images/201509/thumb_img/430_thumb_G_1441150995030.png"
                  },
                  "activity_type": "GENERAL_GOODS",
                  "object_id": 0,
                  "saving_price": 0,
                  "formatted_saving_price": "已省0元"
            },],
            "follower" : "60",
            "shop_closed":1, //到家1.16增加
            "is_follower" : "0",
            "goods_count" : 13,
            "favourable_list" : [{
                  "name" : "双十一五折",
                  "type" : "price_discount",
                  "type_label" : "满折",
            }],
            "allow_use_quickpay":0,
            "quickpay_activity_list" : [{
                  "activity_id " : "2",
                  "title" : "满100减8元",
                  "activity_type" : "reduced",
                  "label_activity_type" : "满减",
                  "limit_time_type":"customize",
                  "limit_time_weekly":"星期一,星期二",
                  "limit_time_daily":"07:00-12:00",
                  "limit_time_exclude":"2017-08-20",
            }],
            "distance" : 100,
      }         
      "status": {
             "succeed": 1,
      },
      "paginated": {
            "total": 13,
            "count": 13,
            "more": 1
      }
}

失败举例如下

注:错误编码