基础 qianmi.cloudshop.items.all.list(获取商家所有商品列表)

初始化同步商品接口,获取商家所有的商品仓库商品列表,该API 包含了所有上下架商品,新接入用户初始化商品请调用此接口
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
fieldsField List 必须 num_iid,title,price 该接口只返回item商品结构中的以下字段:cid,pic_url,num, list_time,delist_time,price,modified,d2c_approve_status,d2p_approve_status,num_iid, title,user_nick,unit,item_weight,outer_id,brand_id,brand_name,is_fenxiao,sub_stock,想要获取所有字段,请根据商品编号获取单个商品详情
page_sizeString 可选 5050 每页条数,取大于0的整数,最大值50
page_noString 可选 00 当前页码,从0开始,整数
order_byString 可选 num:asc 排序格式:column:asc/desc column可选值:cid(标准类目编号)、num(商品数量),brand_id(品牌编号),type_id(商品类型编号)
cidString 可选 1003 类目编号,如果传此编号则只查询该类目及其下级类目的所有商品,不传则不关联类目,查询所有商品
查询未关联任何类目的商品,cid传 -1 即可
brand_idString 可选 51265 品牌编号,如果传此编号,则查询此品牌的所有商品
stock_warnString 可选 0 库存预警状态,0-库存充足,1-库存预警
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemsAllListRequest req = new ItemsAllListRequest();
req.setFields("num_iid,title,price");
req.setPageSize("5");
req.setPageNo("0");
ItemsAllListResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new ItemsAllListRequest;
$req->setFields("num_iid,title,price");
$req->setPageSize("5");
$req->setPageNo("0");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
ItemsAllListRequest req = new ItemsAllListRequest();
req.Fields = "num_iid,title,price";
req.PageSize = "5";
req.PageNo = "0";
ItemsAllListResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
items Item[] 商品信息
total_results Number 总条数
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
 FAQ