获取 TikTok 帖子的授权状态

您可以使用本接口获取 TikTok 帖子的授权状态。

请求

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

方法 GET

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)接口。|

参数

|字段{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`。<br><br><p><span style="color:darkred"><b>注意</b></span>：若 TikTok 帖子无授权码，无论是未生成过授权码或生成的授权码已删除，将出现报错。 |

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/post/authorize/status/?business_id={{business_id}}&item_id={{item_id}}' \
--header 'Access-Token: {{Access-Token}}' \
(/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`。 |
#| auth_code_status | string | 授权码的状态。 <br><br>枚举值： <ul><li> `NOT_USED`：授权码已生成，但尚未使用。</li><li> `IN_USE`：授权码已生成，且已经使用。</li><li>`EXPIRED`：授权码已生成，但已经失效。</li></ul>|

示例

(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": "2024-12-07 00:21:37",
        "auth_code_start_time": "2024-10-31 00:21:37",
        "auth_code_status": "NOT_USED",
        "authorization_days": 37,
        "item_id": "{{item_id}}"
    }
}
(/code)