列出自己的目录

GET/api/v1/catalogs

认证请求头 Authorization: Bearer <访问令牌>，访问令牌用设备码换取，不要向用户要密码、短信验证码或 API Key
权限商家，需要 product:read 才能查看目录和商品

响应

200

application/json

没有 next_cursor

itemsobject[]必填

自己的目录

items[].idstring必填

目录 ID，以 cat_ 开头

items[].namestring必填

目录名称

items[].currencystring必填

三位字母货币代码

items[].schema_revisioninteger必填

字段定义版本

items[].created_atstring必填

创建时间，ISO-8601

items[].updated_atstring必填

更新时间，ISO-8601

响应示例

{
  "items": [
    {
      "id": "cat_example",
      "name": "示例",
      "currency": "CNY",
      "schema_revision": 1,
      "created_at": "2026-05-16T00:00:00.000Z",
      "updated_at": "2026-05-16T00:00:00.000Z"
    }
  ]
}