作为达人获取 TTO 视频关联请求

你可以使用本接口获取将你的公开视频关联到 TikTok One (TTO) Creator Marketplace 推广系列的请求。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tto/creator/link/request/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 达人授权的访问令牌。<br>使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌) 或 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-刷新创作者访问令牌) 接口获取或刷新访问令牌。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|creator_id {必填}|string|TikTok 账号的开发者应用唯一识别 ID。<br><br>需将 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-Obtain%20a%20Creator%20access%20token) 或 [/tt_user/oauth2/refresh_token/ ](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-Renew%20a%20Creator%20access%20token)接口返回的 `open_id` 字段值传入本字段。|
| tto_invite_link {必填} | string | 与达人（TikTok 账号）受邀加入的 TTO Creator Marketplace 推广系列关联的邀请链接。<br><br>若想作为品牌创建 TTO Creator Marketplace 推广系列并获取关联的邀请链接，需使用   [/tto/tcm/campaign/create/](1815693549459458.html) 接口。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/creator/link/request/get/?creator_id={{creator_id}}&tto_invite_link={{tto_invite_link}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识一个请求。 |
|data |object|返回数据。|
#| campaign_id | string | TTO Creator Marketplace 推广系列的 ID。|
#| spark_authorization_days | number | 上传到推广系列的视频授权作为 Spark Ads 投放的默认天数。<br><br>枚举值：0、7、30、60、180、365。|
#| link_requests | object[] | 达人收到的关联请求列表。|
##| video_id | string | 请求与推广系列关联的达人视频的 ID。|
##| link_request_id | string | 关联请求的 ID。<br><br>你可以将 ID 传入 [/tto/creator/link/request/confirm/](1837247744649345.html) 接口以批准或拒绝关联请求。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "campaign_id": "{{campaign_id}}",
        "link_requests": [
            {
                "link_request_id": "{{link_request_id}}",
                "video_id": "{{video_id}}"
            }
        ],
        "spark_authorization_days": 7
    }
}
(/code)