撤销短期访问令牌

您可以使用本接口撤销短期访问令牌。

短期访问令牌是从 TikTok 账户获取授权后生成的访问令牌类型。该令牌有效期为一天。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| client_id {必填} | string |开发者应用 ID。<br><br>若想获取<strong>应用ID</strong>，您可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。|
| client_secret {必填} | string | 开发者应用密钥。<br><br>若想获取<strong>密钥</strong>，您可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。|
| access_token{必填} | string | 您想要撤销的 TikTok 账号访问令牌。<br><br>您可使用[/tt_user/oauth2/token/](1833997638479041.html)创建新的访问令牌，或使用[/tt_user/oauth2/refresh_token/](1833997679342594.html)获取刷新后的访问令牌。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
--header 'Content-Type: application/json' \
--data '{
    "client_id":"{{client_id}}",
    "client_secret":"{{client_secret}}",
    "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| 返回数据。 |

示例

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