查询产品列表
支持平台: 淘宝
查询产品列表
支持平台: 淘宝
需授权
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
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 | 是 | 返回具体结果集数据 |
1 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | { "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, "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" }] } }] } } |
错误码 | 错误描述 | 解决方案 |
---|