获取当前用户作为卖家的出售中的商品列表，并能根据传入的搜索条件对出售中的商品列表进行过滤
只能获得商品的部分信息，商品的详细信息请通过taobao.item.seller.get 获取
点击查看更多商品API说明
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| fields | String | 必须 | num_iid,title,price | 需返回的字段列表。可选值：Item商品结构体中的以下字段： approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru,list_time,price,has_discount,has_invoice,has_warranty,has_showcase,modified,delist_time,postage_id,seller_cids,outer_id,sold_quantity ；字段之间用“,”分隔。不支持其他字段，如果需要获取其他字段数据，调用taobao.item.seller.get 获取。 | |
| q | String | 可选 | N97 | 搜索字段。搜索商品的title。 | |
| cid | Number | 可选 | 1512 | 商品类目ID。ItemCat中的cid字段。可以通过taobao.itemcats.get取到 | |
| seller_cids | String | 可选 | 11 | 卖家店铺内自定义类目ID。多个之间用“,”分隔。可以根据taobao.sellercats.list.get获得.(注：目前最多支持32个ID号传入) | |
| page_no | Number | 可选 | 10 |
|
页码。取值范围:大于零的整数。默认值为1,即默认返回第一页数据。用此接口获取数据时，当翻页获取的条数（page_no*page_size）超过10万,为了保护后台搜索引擎，接口将报错。所以请大家尽可能的细化自己的搜索条件，例如根据修改时间分段获取商品 |
| page_size | Number | 可选 | 100 |
|
每页条数。取值范围:大于零的整数;最大值：200；默认值：40。用此接口获取数据时，当翻页获取的条数（page_no*page_size）超过2万,为了保护后台搜索引擎，接口将报错。所以请大家尽可能的细化自己的搜索条件，例如根据修改时间分段获取商品 |
| order_by | String | 可选 | list_time:desc |
|
排序方式。格式为column:asc/desc ，column可选值:list_time(上架时间),delist_time(下架时间),num(商品数量)，modified(最近修改时间)，sold_quantity（商品销量）,;默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为list_time:desc |
| has_discount | Boolean | 可选 | true | 是否参与会员折扣。可选值：true，false。默认不过滤该条件 | |
| has_showcase | Boolean | 可选 | true | 是否橱窗推荐。 可选值：true，false。默认不过滤该条件 | |
| is_taobao | Boolean | 可选 | true | 商品是否在淘宝显示 | |
| is_ex | Boolean | 可选 | true | 商品是否在外部网店显示 | |
| start_modified | Date | 可选 | 2000-01-01 00:00:00 | 起始的修改时间 | |
| end_modified | Date | 可选 | 2000-01-01 00:00:00 | 结束的修改时间 | |
| is_cspu | Boolean | 可选 | true | 是否挂接了达尔文标准产品体系 | |
| is_combine | Boolean | 可选 | true | 组合商品 | |
| auction_type | String | 可选 | a | 商品类型：a-拍卖,b-一口价 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| total_results | Number | 150 | 搜索到符合条件的结果总数 |
| items | Item [] | 搜索到的商品列表，具体字段根据设定的fields决定，不包括desc字段 | |
|
|||
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);ItemsOnsaleGetRequest req = new ItemsOnsaleGetRequest();req.setFields("num_iid,title,price");req.setQ("N97");req.setCid(1512L);req.setSellerCids("11");req.setPageNo(10L);req.setPageSize(100L);req.setOrderBy("list_time:desc");req.setHasDiscount(true);req.setHasShowcase(true);req.setIsTaobao(true);req.setIsEx(true);req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));req.setEndModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));req.setIsCspu(true);req.setIsCombine(true);req.setAuctionType("a");ItemsOnsaleGetResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
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 | <items_onsale_get_response> <total_results>150</total_results> <items> <item> <approve_status>onsale</approve_status> <iid>13232</iid> <num_iid>1489161932</num_iid> <title>Google test item</title> <nick>tbtest561</nick> <type>fixed</type> <cid>132443</cid> <seller_cids>2234445,3344466,446434</seller_cids> <num>8888</num> <props>135255:344454</props> <valid_thru>7</valid_thru> <list_time>2009-10-22 14:22:06</list_time> <price>5.00</price> <has_discount>true</has_discount> <has_invoice>true</has_invoice> <has_warranty>true</has_warranty> <has_showcase>true</has_showcase> <modified>2000-01-01 00:00:00</modified> <delist_time>2000-01-01 00:00:00</delist_time> <postage_id>32</postage_id> <outer_id>34143554352</outer_id> <is_ex>true</is_ex> <is_virtual>true</is_virtual> <is_taobao>true</is_taobao> <sold_quantity>8888</sold_quantity> <is_cspu>true</is_cspu> <first_starts_time>2000-01-01 00:00:00</first_starts_time> </item> </items></items_onsale_get_response> |
1 2 3 4 5 6 | <error_response> <code>50</code> <msg>Remote service error</msg> <sub_code>isv.invalid-parameter</sub_code> <sub_msg>非法参数</sub_msg></error_response> |
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| isv.invalid-parameter:gain-number-too-large | 翻页数量超过10万 | 翻页数超过10万后台搜索引擎查询会超时，所以api做了限制，如果翻页（pageNo*pageSize）超过10万，api这边会直接报错。对于实时搜索的3个接口：items.all.get,items.onsale.get,items.inventory.get，调用的时候要尽量细化查询条件，无条件批量查询的，翻页过多会超时和报错 |
| 错误码：40，子错误码：null | 缺少必要的传入参数 | |
| 错误码：41，子错误码：null | 传入参数的格式错误 | |
| isv.user-not-exist:invalid-nick | user 不存在 | 传入的nick找不到对应的用户记录，尽量通过接口获取nick来查询，并且定期更新自己的nick数据 |
| isp.item-instant-search-service-unavailable | 翻页获取的条数（page_no*page_size）超过2万，为了保护后台搜索引擎，接口报错 | 细化搜索条件，例如根据修改时间分段获取商品 |
| isv.invalid-parameter | 缺少必要的传入参数 | 确定入参的正确性 |
| isv.invalid-parameter:gain-number-too-large-tmall | 数字超过大小范围 | 确定数字格式正确性 |
| isp.service-unavailable-tmall | 服务不可用 | 重试 |
| isp.top-remote-connection-timeout-tmall | 接口响应超时 | 重试 |
| isv.user-not-exist:invalid-nick-tmall | 用户信息不存在 | 确定用户的正确性 |
| system_error | 系统错误 | 重试 |
| isp.service-unavailable | 系统错误 | 偶尔出现重试，频繁出现反馈平台 |
| isv.invalid-parameter:modified-range-tmall | 查询的modified区间错误 | start_modified必需小于等于end_modified |
| isp.top-remote-method-connection-error-tmall | 系统错误 | 重试 |
| isv.invalid-parameter:modified-range | 查询的modified区间错误 | start_modified必需小于等于end_modified |
