跳转到主要内容
GET
/
api
/
seller
/
v1
/
brands
List token-authorized brands
curl --request GET \
  --url https://app.openlight.tech/api/seller/v1/brands \
  --header 'Authorization: Bearer <token>'
{
  "brands": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "logo_url": "<string>",
      "website": "<string>",
      "product_count": 123,
      "amazon_regions": [
        "<string>"
      ],
      "amazon_marketplaces": [
        "<string>"
      ]
    }
  ],
  "next_cursor": "<string>"
}
使用该接口获取当前卖家或运营 Token owner 被授权访问的品牌列表。运营账号属于商家端角色,只能看到被授权的品牌。 列表接口支持游标分页:limit 默认 25、最大 100,传入上一页返回的 next_cursor 作为 cursor 可继续读取下一页;没有更多结果时 next_cursornull 响应字段:
  • id:品牌 ID。
  • name:品牌名称。
  • description:品牌简介,可能缺省。
  • logo_url:品牌 Logo 图片 URL,可能缺省。
  • website:品牌官网 URL,可能缺省。
  • status:品牌自身状态。
  • product_count:当前可见商品数量,可能缺省。
  • amazon_regions:品牌当前有 active 商品覆盖的 Amazon 国家/地区码,可能缺省。
  • amazon_marketplaces:Amazon 站点域名,例如 amazon.comamazon.co.uk,可能缺省。
  • partnership_status:当前 Token owner 与品牌的合作状态;卖家侧通常不依赖该字段判断授权范围。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

limit
integer
默认值:25

每页返回数量,默认 25,最大 100。Number of items per page; defaults to 25 and maxes out at 100.

必填范围: x <= 100
cursor
string

上一页响应返回的下一页游标。Cursor returned as next_cursor by the previous page.

响应

Authorized brands

brands
object[]
必填

品牌列表。List of brands.

next_cursor
string | null
必填

下一页游标;为 null 表示没有更多结果。Cursor for the next page; null means there are no more results.