产品列表
请求URL:
https://openapi.weixin12315.com/api/sign/md.shop.products/v1/list
请求方式:
POST
请求示例:
IAuth auth = new Sign("app_id", "app_secret"); IClient client = new SignClient(auth); IDictionary<string, object> parameters = new Dictionary<string, object>(); parameters.Add("page",1); parameters.Add("pagesize",10); parameters.Add("query", JsonConvert.SerializeObject(new { prostate = "1", name = "", category = "", noprotype = "0", protypeid1 = "", protypeid2 = "", showstate = "", pronumber = "", isvirtual = "" })); parameters.Add("sort",""); string apiurl="https://openapi.weixin12315.com"; var result = client.Call(apiurl,"md.shop.products.list", "v1", "POST", parameters);
请求参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
page | 是 | string | 从第几页开始 (默认第1页) |
pagesize | 是 | string | 取多少条 (默认10条) |
query | 是 | json | 查询条件 ( 子项值为空,则默认不查询该条件值) |
sort | 否 | string | 排序条件,默认倒叙 默认排序字段sequence 排序值:price(价格),stock(库存),salecounts(销量),status(上架状态),addtime(发布时间) |
query参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
prostate | 是 | int | 商品状态(0:正常;1:回收站), |
name | 否 | string | 产品名称 |
category | 否 | string | 产品分组编号 |
noprotype | 是 | string | 查询未分类商品 (0:查询所有分类; 1:只显示未分类商品) |
protypeid1 | 否 | string | 一级分类 |
protypeid2 | 否 | string | 二级分类 |
showstate | 否 | string | 是否上架(0:下架,1:上架) |
pronumber | 否 | string | 产品编码 |
isvirtual | 否 | string | 产品类型 (0:实物 ;1:虚拟) |
返回示例
{ "error_code": 0, "error_msg": "success", "return_data": { "total":1000, "datalist": { "productid": 1, "categroy1": 2, "name": "加多宝", "price": 3, "originalprice ": 4.5, "authorIntroduction": "金罐加多宝", "productintroduction": "广东加多宝", "stock": 1000, "homerecommended": 0, "salecounts": 100, "publishedtime": "2017-03-12 17:10:50", "memberlogin": "10000107", "status": 0, "picurl1": "", "picurl2": "", "picurl3": "", "picurl4": "", "picurl5": "", "sequence": 10, "giftstag": 0, "reminded": "", "unit": "瓶", "ispopular": 1, "showtime": "2017-03-12 17:10:50", "points": 10, "isformat": 0, "description": "", "weight": 1, "isqa": 1, "protype": 0, "isvirtual": 0, "proggstr1": "", "proggstr2": "", "proggstr3": "", "pronumber": "", "isfreightfree": 0, "istiming": 0, "brandtradersname":"", "productname":"", "barcode":"", "updatetime":"", "nosaletypeid:"" , "protypelist":[ { "typeid": 687, "typename": "产品分类测试", "parentid": 0 } ] } } }
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
error_code | string | 错误编码 |
error_msg | string | 错误描述 |
retrun_data | json | 返回数据,详细见“retrun_data 参数说明” |
retrun_data返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
total | int | 记录总数 |
datalist | json[] | 返回数据集,详细见“retrun_data 参数说明” |
datalist 参数说明
参数名 | 类型 | 说明 |
---|---|---|
productid | int | 商品id |
categroy1 | int | 一级分类ID |
name | string | 商品名称 |
price | Decimal(14,2) | 价格(现价) |
originalprice | Decimal(14,2) | 市场价格 |
authorintroduction | string | 产品亮点 |
productintroduction | string | 商品内容简介 |
stock | int | 库存量 |
homerecommended | int | 首页推荐 ,0:表示不推荐;1:表示推荐。 |
salecounts | int | 销售量 |
publishedtime | datetime | 发布时间 |
status | int | 审核状态,默认为0 , 0:仓库中;1:出售中 |
picurl1 | string | 产品图片1 |
picurl2 | string | 产品图片2 |
picUrl3 | string | 产品图片3 |
PicUrl4 | string | 产品图片4 |
picUrl5 | string | 产品图片5 |
sequence | int | 排序 |
giftstag | int | 0:表示是正常商品;1:表示礼品 |
reminded | string | 产品特别提醒 |
unit | string | 产品单位 |
ispopular | string | 是否人气产品(0),0:非;1:是 |
showtime | string | 上架时间 |
points | int | 赠送积分 |
isformat | int | 是否有规格 0:没有;1:有 |
description | string | 商品描述 |
weight | Decimal(14,2) | 产品重量 |
isqa | int | 是否通过质量鉴证 0:未认证;1:认证成功(名牌产品) |
protype | int | 产品类型 0:正品(默认);1:非卖品 |
isvirtual | string | 是否是虚拟商品 0:否;1:是 |
proggstr1 | string | 产品规格1 |
proggstr2 | string | 产品规格2 |
proggstr3 | string | 产品规格3 |
pronumber | string | 商品编号 |
isfreightfree | string | 是否免运费 0:默认使用当前已启用的运费模板;1:免运费 |
istiming | string | 是否开启定时上架 0:默认不开启;1:开启 |
brandtradersname | string | 品牌名称 |
productname | string | 产品标题 |
barcode | string | 产品条码 |
updatetime | string | 更新时间 |
nosaletypeid | int | 非卖品分类ID |