通过访问令牌获取已授权的 TikTok 账号权限范围

您现在可以使用本接口获取 TikTok 用户已授予的 TikTok 企业号或 TikTok 个人账号的权限范围信息。

若您想获取已加入TikTok Creator Marketplace的创作者授予的 TikTok 创作者账户（此时为 TikTok 个人账号）权限范围信息，请查看这里。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/

方法 POST

Header

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

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|app_id  {必填}|string|开发者应用ID。您可以导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>，获取<strong>应用ID</strong>。|
|access_token {必填} |string|用于权限验证的访问令牌。<br><br>若想获取在 TikTok 账号用户授予 TikTok 账号权限后生成的访问令牌，请查看[获取访问令牌](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)。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/'
--header 'Content-Type: application/json'
--data-raw '{
    "app_id":"{{app_id}}",
    "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| 返回数据。 |
#|app_id |string |开发者应用ID。|
#|scope|string|所指定访问令牌的权限范围。<br>例如，`"user.info.basic,video.list"`。|
#|creator_id|string| TikTok 账号的应用唯一识别ID。<br><p><span style="color:darkred"><b>注意</b></span>：您可把本字段的值传给[账号 API](https://ads.tiktok.com/marketing_api/docs?id=1737944775511041)请求中的`business_id`字段。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "app_id": "{{app_id}}",
        "creator_id": "{{creator_id}}",
        "scope": "video.publish,user.info.basic,video.list,user.insights,user.insights.creator,tcm.order.update,comment.list.manage,video.insights,comment.list"
    }
}
(/code)