查询商品列表 - 闲管家开放平台

请求参数

Query 参数

appid

integer

必需

开放平台的AppKey

默认值:

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

seller_id

integer

可选

商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

online_time

array[integer <int64>]

商品上架时间

可选

第一个元素值为开始时间戳,第二个元素值为结束时间戳

>= 2 items<= 2 items

offline_time

array[integer <int64>]

商品下架时间

可选

第一个元素值为开始时间戳,第二个元素值为结束时间戳

>= 2 items<= 2 items

sold_time

array[integer <int64>]

商品售罄时间

可选

第一个元素值为开始时间戳,第二个元素值为结束时间戳

>= 2 items<= 2 items

update_time

array[integer <int64>]

商品更新时间

可选

第一个元素值为开始时间戳,第二个元素值为结束时间戳

>= 2 items<= 2 items

create_time

array[integer <int64>]

商品创建时间

可选

第一个元素值为开始时间戳,第二个元素值为结束时间戳

>= 2 items<= 2 items

product_status

enum<integer> <int32>

管家商品状态

可选

product_status和sale_status均传入时，优先使用product_status

枚举值:

-1212223313336

默认值:

0

示例值:

21

sale_status

enum<integer> <int32>

销售状态

可选

枚举值：1 : 待发布2 : 销售中3 : 已下架

枚举值:

123

默认值:

0

示例值:

1

page_no

integer <int32>

页码

可选

注意：description: 传入值为1代表第一页，传入值为2代表第二页，依此类推

>= 1<= 100

默认值:

1

page_size

integer <int32>

每页行数

可选

注意：当翻页获取的条数（page_no*page_size）超过1万，接口将报错，所以请大家尽可能的细化自己的搜索条件，例如缩短修改时间分段获取商品

>= 1<= 100

默认值:

50

示例

{
  "online_time": [
    1690300800,
    1690366883
  ],
  "offline_time": [
    1690300800,
    1690366883
  ],
  "sold_time": [
    1690300800,
    1690366883
  ],
  "update_time": [
    1690300800,
    1690366883
  ],
  "create_time": [
    1690300800,
    1690366883
  ],
  "product_status": 21,
  "page_no": 1,
  "page_size": 50
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/api/open/product/list?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "online_time": [
        1690300800,
        1690366883
    ],
    "offline_time": [
        1690300800,
        1690366883
    ],
    "sold_time": [
        1690300800,
        1690366883
    ],
    "update_time": [
        1690300800,
        1690366883
    ],
    "create_time": [
        1690300800,
        1690366883
    ],
    "product_status": 21,
    "page_no": 1,
    "page_size": 50
}'

返回响应

🟢200成功

application/json

Body

code

integer <int32>

必需

默认值:

0

msg

string

必需

默认值:

OK

data

object

数据

必需

list

array [object {22}]

列表数据

必需

count

integer <int32>

查询总数

必需

page_no

integer <int32>

页码

必需

page_size

integer <int32>

每页行数

必需

示例

成功示例异常示例

{
  "code": 0,
  "msg": "OK",
  "data": {
    "list": [
      {
        "product_id": 448592974859525,
        "product_status": 31,
        "item_biz_type": 2,
        "sp_biz_type": 27,
        "channel_cat_id": "48b41f39bc7cb246267e0a01017d9f44",
        "original_price": 400000,
        "price": 400000,
        "stock": 2,
        "title": "测试0717食品-海外",
        "district_id": 130100,
        "outer_id": "CS-230717",
        "stuff_status": 60,
        "express_fee": 1,
        "spec_type": 1,
        "source": 14,
        "specify_publish_time": 0,
        "online_time": 1691656170,
        "offline_time": 1691657197,
        "sold_time": 0,
        "update_time": 1691657199,
        "create_time": 1691656171
      }
    ],
    "count": 100,
    "page_no": 1,
    "page_size": 5
  }
}

🟢200失败