产品列表
请求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 |