撤销长期访问令牌

您可以使用本接口撤销长期访问令牌。本接口是 TikTok API for Business v1.3 中的全新接口。

长期访问令牌是从广告账户、商务中心账户或 TikTok One Creator Marketplace 账户获取授权后生成的访问令牌类型。该令牌不会过期。

您需先使用/oauth2/access_token/ 或/oauth/token/生成访问令牌。

请求

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

方法 POST

Header

|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
|app_id {必填}|string| 开发者应用 ID。<br><br>若想获取<strong>应用 ID</strong>，可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。 |
|secret{必填}|string|开发者应用密钥。<br><br>若想获取<strong>密钥</strong>，可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>。|
|access_token{必填}|string|您想要撤销的长期访问令牌。<br><br>您可通过[/oauth2/access_token/](https://business-api.tiktok.com/portal/docs?id=1739965703387137#item-link-/oauth2/access_token/)或[/oauth/token/](https://business-api.tiktok.com/portal/docs?id=1739965703387137#item-link-/oauth/token/)创建新的访问令牌。|

示例

(code curl http)
curl --location  --request POST 'https://business-api.tiktok.com/open_api/v1.3/oauth2/revoke_token/' \
--header 'Access-Token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
    "app_id": "{{app_id}}",
    "secret": "{{secret}}",
    "access_token": "{{access_token}}"
}'
(/code)

返回

|字段|类型|描述|
|---|---|---|
|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|返回数据。  |
#|app_id |string|开发者应用 ID。|
#|advertiser_ids |string[]| 该访问令牌不再有权限访问的广告账户 ID 列表。|

示例

(code curl http)
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_ids": [
            "{{advertiser_ids}}",
            "{{advertiser_ids}}"
        ],
        "app_id": "{{app_id}}"
    }
}
(/code)