跳转到主要内容
GET
/
api
/
creator
/
v1
/
links
List creator attribution links
curl --request GET \
  --url https://app.openlight.tech/api/creator/v1/links \
  --header 'Authorization: Bearer <token>'
{
  "links": [
    {
      "id": "<string>",
      "brand_id": "<string>",
      "product_id": "<string>",
      "url": "<string>",
      "destination_url": "<string>",
      "marketplace": "<string>",
      "tracking_id": "<string>",
      "status": "active",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}
使用该接口获取当前创作者 Token owner 创建过的归因链接。列表接口支持游标分页：limit 默认 25、最大 100，传入上一页返回的 next_cursor 作为 cursor 可继续读取下一页；没有更多结果时 next_cursor 为 null。 响应字段：
  • id：归因链接 ID。
  • brand_id：品牌 ID。
  • product_id：商品 ID。
  • url：可分发的归因链接 URL。
  • destination_url：Amazon 落地页 URL，通常为商品详情页或创建链接时传入的目标页。
  • marketplace：归因链接对应的 Amazon 站点域名，例如 amazon.com、amazon.co.uk、amazon.de。该字段用于判断链接所属站点，不表示合作状态，也不是追踪 tag。
  • tracking_id：创建链接时传入的客户侧追踪标识；未传入时为空字符串。后续报表会使用该字段帮助下游系统做归因。
  • status：链接状态。当前固定返回 active。
  • created_at：链接创建时间。
相关接口：如需创建新的归因链接，请使用 创建归因链接。

授权

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

响应

Creator links

​
links
object[]
必填

归因链接列表。List of attribution links.

​
next_cursor
string | null
必填

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