跳转到主要内容
POST
/
api
/
creator
/
v1
/
links
Create an attribution link
curl --request POST \
  --url https://app.openlight.tech/api/creator/v1/links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": "<string>",
  "product_id": "<string>",
  "destination_url": "<string>",
  "tracking_id": "<string>"
}
'
{
  "link": {
    "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"
  }
}
使用该接口为某个品牌商品创建推广归因链接。请求必须包含 brand_id 和 product_id，也可以传入可选的 tracking_id、destination_url。 字段说明：
  • tracking_id：客户侧追踪标识，最多 200 个字符。建议把下游系统里的 tag、campaign、source 等追踪值放在这里；前后空白会被裁剪，不能包含 ASCII 控制字符。创建成功后会在创建响应和列表响应中返回规范化后的值，后续报表也会使用该字段做下游归因。
  • destination_url：Amazon 落地页 URL，可选。未传入时默认使用商品详情页；它决定用户点击后进入哪个 Amazon 页面，不承担追踪 tag 的作用。
成功时返回 201 和 { "link": LinkDTO }。 创建成功后，响应里的 marketplace 会返回该链接对应的 Amazon 站点域名，例如 amazon.com、amazon.co.uk、amazon.de。该字段用于判断链接所属站点，不表示合作状态，也不是追踪 tag。 可能的错误：
  • 400 invalid_request：请求体不完整或字段无效。
  • 403 forbidden_resource：当前 Token owner 无权访问该品牌或商品。
  • 403 ads_not_connected：品牌广告连接状态不满足创建要求。
  • 404 product_not_found：商品不存在或不可访问。
相关接口：如需查看已创建的归因链接，请使用 列出归因链接。

授权

​
Authorization
string
header
必填

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

请求体

application/json
​
brand_id
string
必填

品牌 ID。Brand ID.

​
product_id
string
必填

商品 ID。Product ID.

​
destination_url
string

Amazon 落地页 URL；可选，默认使用商品详情页。Amazon landing page URL; optional, defaults to the product detail page.

​
tracking_id
string

客户侧追踪标识；可选，前后空白会被裁剪，不能包含 ASCII 控制字符。创建和列表响应会返回规范化后的值，后续报表也会使用该字段做下游归因。Client-side tracking tag; optional, leading/trailing whitespace is trimmed and ASCII control characters are rejected. Create/list responses return the normalized value, intended for downstream reporting.

Maximum string length: 200

响应

Attribution link created

​
link
object
必填