获取已授权的创作者权限

你可以使用本接口获取 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。<br><br>您可以导航至 <strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>，获取<strong>应用ID</strong>。|
|access_token {必填} |string|用于权限验证的访问令牌。<br><br>欲获取在 TikTok One（TTO）创作者授予 TikTok创作者账户权限后生成的访问令牌，请查看[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/get-renew-or-revoke-a-creator-access-token/v1.3#item-link-获取创作者访问令牌)。|

示例

(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。|

示例

(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)