查询供应商列表

GET 
/openapi/2026-01/suppliers

分页返回供应商列表。

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数

page int32

页码（从 1 开始），与 cursor 互斥

ids uint64[]

用于筛选的供应商 ID 列表；为空时返回全部供应商。 示例：?ids=1001&ids=1002

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

suppliers object[]

供应商列表

Array [

iduint64

供应商 ID

titlestring

供应商名称

urlstring

供应商 URL

created_atstring

创建时间（ISO-8601 格式）

updated_atstring

最后更新时间（ISO-8601 格式）

]

cursorstring

下一页游标

has_moreboolean

是否有更多记录

totalint32

全部页的总记录数(供 page 模式分页计算总页数)

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "suppliers": [
      {
        "id": 0,
        "title": "string",
        "url": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}