延长 TikTok 帖子的授权有效期

您可以使用本接口延长 TikTok 帖子已有授权码的有效期。

注意
若帖子的授权码被删除，您可以使用本接口为帖子生成新授权码。

使用前需知

确保帖子已开启“广告授权”设置，否则会出现报错。

若想为帖子开启“广告授权”设置，可使用/business/post/authorize/setting/并将 is_ad_promotable 设置为 true。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|business_id {必填}| string | TikTok 账户的应用唯一识别 ID。<br><br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-%E8%8E%B7%E5%8F%96%20TikTok%20%E8%B4%A6%E5%8F%B7%E8%AE%BF%E9%97%AE%E4%BB%A4%E7%89%8C)接口返回的`open_id`字段值传给本字段。|
| item_id {必填} | string | TikTok 帖子 ID。<br><br>若想获取 TikTok 账号的公开帖子，可使用[/business/video/list/](1762228421622786.html)。 <br><br>示例：`7123456789123456789`。 |
| authorization_days | number | <ul><li>若帖子已有授权码，本字段代表授权延长期，即要在现有授权期上延长的授权时间。<ul><li>例如，若当前 TikTok 帖子的授权有效期为 180 天且您将本字段设置为`180`，帖子的授权有效期将延长到 360 天。</li></ul></li><li>若帖子的授权码已删除，本字段代表新生成的授权码的有效期。</li></ul> <br>支持的值：`7`，`30`，`60`，`365`。<br> 默认值：`30`。 |

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "business_id": "{{business_id}}",
    "item_id": "{{item_id}}",
    "authorization_days": 180
}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| item_id | string | TikTok 帖子 ID。 <br><br>示例：`7123456789123456789`。 |
#| auth_code| string | TikTok 帖子的授权码。<br><br>示例：`#1Ea2bcde3fUM/ghijEk/L4mOceft5deFRq6za7JsgnAJ8PB9n1XIr1rC1b/5Rw4=`。 |
#| auth_code_start_time | string | 授权码生效时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0）。<br><br>示例： `2024-01-01 00:00:00`。 |
#| auth_code_end_time | string | 授权码过期时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0）。<br><br>示例： `2024-01-01 00:00:00`。 |
#| authorization_days | number | 授权的有效期，单位为天。<br><br>示例：`360`。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "auth_code": "{{auth_code}}",
        "auth_code_end_time": "2025-10-31 12:58:42",
        "auth_code_start_time": "2024-11-05 12:58:42",
        "authorization_days": 360,
        "item_id": "{{item_id}}"
    }
}
(/code)