详细描述

查询产品列表

支持平台: 淘宝

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
method String

API接口名称

certi_id Number

分配给应用的证书ID

from_node_id String

API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY

from_api_v String

请求方版本号

to_node_id String

API调用的目的节点ID(除了基础服务类api,其他接口必传此参数)

to_api_v String

接收方版本号

callback_url String

响应回调地址,带http路径的标准URL。(调用异步接口此参数必填)

v String

矩阵API协议版本,可选值:1.0

timestamp String

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟

format String

可选,指定响应格式。默认JSON ,目前支持格式为JSON

sign String

对调用API时所有输入参数(包括应用级参数)进行签名结果

应用级输入参数

名称 类型
默认全部
示例值 默认值 描述
outer_id String

淘宝(可选)

xxxx

商家编码

productcat_id Number

淘宝(可选)

123123

产品线ID

status String

淘宝(可选)

up

产品状态,可选值:up(上架)、down(下架),不传默认查询所有

pids Number

淘宝(可选)

123,123,123

产品ID列表(最大限制30),用逗号分割,例如:“1001,1002,1003,1004,1005”

start_modified Date

淘宝(可选)

2000-01-01 00:00:00

开始修改时间

end_modified Date

淘宝(可选)

2000-01-01 00:00:00

结束修改时间

page_no Number

淘宝(可选)

1

页码(大于0的整数,默认1)

page_size Number

淘宝(可选)

50

每页记录数(默认20,最大50)

sku_number String

淘宝(可选)

123123

sku商家编码

is_authz String

淘宝(可选)

yes

查询产品列表时,查询入参“是否需要授权” yes:需要授权 no:不需要授权

item_ids Date

淘宝(可选)

1001,1002,1003,1004,1005

可根据导入的商品ID列表查询,优先级次于产品ID、sku_numbers,高于其他分页查询条件。最大限制20,用逗号分割,例如:“1001,1002,1003,1004,1005”

返回结果

名称 类型 是否必须 示例值 描述
total_results Number

1

返回结果集数据条数

fenxiao_products FenxiaoProduct

返回具体结果集数据

XML数据格式:

			
JSON数据格式:
{    
      "rsp":"fail",
      "msg_id":"3463421b2581604c74dcb9b74ffab2e4"
      "data":{
           "total_results":1,
           "fenxiao_products":[{
                "pid": 1255,
                "name": "jayzhou",
                "productcat_id": 444,
                "standard_price": "5",
                "cost_price": "5",
                "retail_price_low": "10.56",
                "retail_price_high": "10.56",
                "outer_id": 4444,
                "quantity": 444,
                "alarm_number": 444,
                "pictures": "http://img01.taobaocdn.com/xxx.jpg,http://img01.taobaocdn.com/xxx.jpg",
                "desc_path": "http://img03.taobaocdn.com/xxx.dpc",
                "prov": "浙江",
                "city": "杭州",
                "postage_type": "12",
                "postage_id":5545,
                "postage_ordinary": "10.56",
                "postage_fast": "10.56",
                "postage_ems": "12.2",
                "have_invoice": true,
                "have_guarantee": true,
                "status": "up",
                "items_count": 5,
                "orders_count": 5,
                "created": "2000-01-01 00:00:00",
                "modified": "2000-01-01 00:00:00",
                "skus": {
                    "fenxiao_sku": [{
                        "id": "jayzhou",
                        "name": "如鞋子的sku:“红色,35”",
                        "cost_price": "1",
                        "quantity": "1",
                        "outer_id": "1"
                    }]
                }
           }]
      }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2013-05-29 17:59:44