跳转到主要内容
GET
/
api
/
creator
/
v1
/
products
List products visible to the creator
curl --request GET \
  --url https://app.openlight.tech/api/creator/v1/products \
  --header 'Authorization: Bearer <token>'
{
  "products": [
    {
      "id": "<string>",
      "brand_id": "<string>",
      "asin": "<string>",
      "title": "<string>",
      "status": "<string>",
      "commission": {
        "type": "<string>",
        "rate": 123,
        "rate_bps": 123,
        "flat_cents": 123,
        "currency_code": "<string>"
      },
      "image_url": "<string>",
      "detail_page_url": "<string>",
      "marketplace_id": "<string>",
      "country_code": "<string>",
      "price_cents": 123,
      "currency": "<string>"
    }
  ],
  "next_cursor": "<string>"
}
该接口返回当前创作者已批准合作品牌下的商品。请求必须传入 brand_id，并支持游标分页：limit 默认 25、最大 100，传入上一页返回的 next_cursor 作为 cursor 可继续读取下一页；没有更多结果时 next_cursor 为 null。 如果品牌的 partnership_status 不是 approved，接口会返回 403 forbidden_resource。 响应字段：
  • id：商品 ID。
  • brand_id：品牌 ID。
  • asin：Amazon ASIN。
  • title：商品标题。
  • image_url：商品图片 URL，可能缺省。
  • detail_page_url：Amazon 商品详情页 URL，可能缺省。
  • marketplace_id：Amazon marketplace ID，可能缺省。
  • country_code：Amazon 国家/地区码，可能缺省。
  • price_cents：商品价格的最小货币单位金额，可能缺省。
  • currency：价格币种，可能缺省。
  • status：商品自身状态。
  • commission：商品佣金配置，可能为 null。非 null 时包含 type、rate、rate_bps、flat_cents、currency_code。

授权

​
Authorization
string
header
必填

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

查询参数

​
brand_id
string
必填

品牌 ID。Brand ID.

​
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.

响应

Products visible to the creator

​
products
object[]
必填

商品列表。List of products.

​
next_cursor
string | null
必填

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