← 返回目录
📁 API Reference › TikTok One

作为达人批准或拒绝 TTO 视频关联请求

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

请求

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

方法 POST

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-刷新创作者访问令牌) 接口获取或刷新访问令牌。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。 |

参数

|字段{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` 字段值传入本字段。|
| link_request_id {必填} | string | 关联请求的 ID。<br><br>若想获取 ID,需使用 [/tto/creator/link/request/get/](1837247726007298.html) 接口并查看返回的 `link_request_id`。|
| action {必填} | string | 采取的操作。<br><br>枚举值: <ul><li>`APPROVE`:批准关联请求。</li><li>`REJECT`:拒绝关联请求。</li></ul> |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/creator/link/request/confirm/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "creator_id": "{{creator_id}}",
    "link_request_id": "{{link_request_id}}",
    "action": "APPROVE"
}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID,唯一标识一个请求。 |
|data |object|返回数据。<br> <br>如果请求成功,此字段将为空对象 (`{}`)。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {}
}
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →