商品列表查詢接口 · 速賣通 API 文檔

### 商品列表查詢接口 ``` api.findProductInfoListQuery -- version: 1 ``` 主賬號可查詢所有商品，子賬號只可查詢自身所屬商品。 ## 系統級輸入參數 | 名稱 | 類型 | 是否必須 | 描述 | | --- | --- | --- | --- | | _aop_timestamp | String | 否 | 請求時間戳 | | _aop_signature | String | 是 | 請求簽名 | | access_token | String | 是 | 用戶授權令牌 | ## 應用級輸入參數 | 名稱 | 類型 | 是否必須 | 描述 | 示例值 | 默認值 | | --- | --- | --- | --- | --- | --- | | productStatusType | String | 是 | 商品業務狀態，目前提供4種，輸入參數分別是：上架:onSelling ；下架:offline ；審核中:auditing ；審核不通過:editingRequired。 | onSelling | | | subject | String | 否 | 商品標題模糊搜索字段。只支持半角英數字，長度不超過128。 | knew odd | | | groupId | Integer | 否 | 商品分組搜索字段。輸入商品分組id(groupId). | 124 | | | wsDisplay | String | 否 | 商品下架原因：expire_offline(過期下架)，user_offline(用戶手工下架)、violate_offline(違規下架)、punish_offline(處罰下架)、degrade_offline(降級下架)、industry_offline(行業準入未續約下架) | expire_offline | | | offLineTime | Integer | 否 | 商品的剩余有效期。如果想查3天之內即將下架的商品，則offLineTime值為3。 | 7 | | | productId | Long | 否 | 商品id搜索字段。 | 123 | | | exceptedProductIds | Long[] | 否 | 待排除的產品ID列表。 | [123,456] | | | pageSize | Integer | 否 | 每頁查詢商品數量。輸入值小于100，默認20。 | 30 | | | currentPage | Integer | 否 | 需要商品的當前頁數。默認第一頁。 | 2 | | ## 返回結果 | 名稱 | 類型 | 是否必須 | 描述 | 示例值 | | --- | --- | --- | --- | --- | | aeopAEProductDisplayDTOList | [AeopAEProductDisplaySampleDTO[]](http://gw.api.alibaba.com/dev/doc/intl/message.htm?n=AeopAEProductDisplaySampleDTO&ns=aliexpress.open&t=2&a=api.findProductInfoListQuery&v=1) | 是 | 商品基本信息列表 | | | totalPage | int | 是 | 總頁數 | 100 | | currentPage | int | 是 | 當前頁 | 10 | | productCount | int | 是 | 總商品數 | 1021 | | success | boolean | 是 | 接口調用結果 | true | ## 錯誤碼 | 錯誤碼 | 錯誤描述 | 解決方案 | | --- | --- | --- | | 09005999 | 查詢會員信息超時。 | 系統內部異常，請聯系技術支持。 | | 09005005 | 會員帳戶不存在。 | 請檢查賣家賬戶是否合法，有沒有被禁用。 | | 09010996 | pageSize參數超過了100。或者會員信息不存在。 | | | 09010002 | productStatusType參數取值不合法。合理的取值應該是：offline(下架)、onSelling(上架)、editingRequired(審核不通過)、auditing(審核中)、approved(審核通過, 包含上架和下架) | | | 09010003 | wsDisplay參數取值不合法。這個參數可以不提供，但是如果提供了，請使用以下幾個候選值中的一個：expire_offline(過期下架)，user_offline(用戶手工下架)、violate_offline(違規下架)、punish_offline(處罰下架)、degrade_offline(降級下架)、industry_offline(行業準入未續約下架) | | | 09010007 | longProductIds參數中產品ID個數超過了50個。 | | | 09010008 | exceptedProductIds參數中的產品ID個數超過了200個。 | | | 09015111 | 當前賣家未綁支付寶賬戶和未通過實名認證。 | | | 09019999 | 系統錯誤，無法查詢商品信息。 | 系統內部異常，請聯系技術支持。 | | 09009999 | 系統未知異常。 | 系統內部異常，請聯系技術支持。 |