获取达人授权

步骤

与达人分享 TikTok 账户授权 URL。
达人授权您的开发者应用。
进行一次 API 调用以获取访问令牌。
当访问令牌过期时，调用刷新令牌的接口以获取新的访问令牌。访问令牌的有效期为 24 小时，刷新令牌的有效期为 1 年。
（可选）撤销访问令牌。

步骤 1：与达人分享授权 URL

找到您开发者应用的 TikTok 账户授权 URL，并将其分享给达人。该 URL 可通过导航至 我的应用 > App Detail > 基本信息 > TikTok 账户授权 URL。

为确保用户在验证应用时不会出现报错，需要上传一个 App 标志图片，用户将在授权流程中看到该图片。如果您尚未上传App 标志图片，则需要上传一张 JPG、JPEG 或 PNG 格式的图片，其尺寸不得超过 512 x 512 像素。

如果您忘记上传App 标志，用户在尝试授权该应用时将会看到一个错误页面。以下是该错误页面的简要示例：

重定向 URL 的格式规则

注意
每个开发者应用程序最多可以配置 10 个 TikTok 账户持有人重定向 URL。重定向 URL 启用后会自动生成一个新的 TikTok 账户授权 URL。系统仅支持启用一个重定向 URL，启用状态的重定向 URL 用红色标记。仅存在一个 TikTok 重定向 URL 时，默认启用该 URL。若存在多个重定向 URL，可通过点击想启用的 URL 来进行启用。

Alternative Text

在为您的应用定义 TikTok 账户持有者重定向 URL 时，遵循以下格式规则以确保其正常运行：

| 序号 {7%} | 规则 {24%}| 正确示例 {32%}| 错误示例 {37%} |
|---|---|---|---|
| 1 | URL 必须是绝对路径，且必须以 `/` 结尾。| `https://dev.example.com/auth/callback/` | <ul><li> `https://dev.example.com/auth/callback` <ul><li> 缺少结尾的 `/`</li></ul></li><li> `/auth/callback/` <ul><li>  缺少协议和域名 </li></ul></li></ul>|
| 2 | URL 应当是静态的，不支持参数，参数将被忽略。 | `https://dev.example.com/auth/callback/` | <ul><li>`https://dev.example.com/auth/callback/?id=1`<ul><li> 包含了查询参数 `?id=1`</li></ul></li></ul>|
| 3 | URL 不能包含锚点 `#`。 | `https://dev.example.com/auth/callback/` | <ul><li>`https://dev.example.com/auth/callback/#1` <ul><li> 包含了锚点 `#1`</li></ul></li></ul>|
| 4 | URL 必须以 `https://` 开头。 | `https://dev.example.com/auth/callback/` | <ul><li>`http://dev.example.com/auth/callback/` <ul><li> 使用了 `http` 而非 `https` </li></ul></li></ul>|
| 5 | URL 不能包含端口号。 | https://dev.example.com/auth/callback/ | <ul><li>` https://dev.example.com:3000/auth/callback/` <ul><li> 包含了端口号 `:3000`  </li></ul></li></ul> |
| 6 | 所注册 URI 的长度应在 10 到 512 个字符之间。| N/A| N/A|

否则，您将收到如下错误信息。您可以据此编辑您的重定向 URL。

步骤 2：达人授予授权

创作者打开授权 URL 时，系统会请求创作者为您的开发者应用授权。点击授权按钮后，创作者将跳转到您的开发者应用的重定向 URL。该重定向 URL 中将会包含 code= <param>，这是获取访问令牌所需的 auth_code 参数。

重要提示
授权码 auth_code 有效时间为 10 分钟，且仅可使用一次。过期后，您需要重新进行授权流程来获取一个新的授权码。

达人授权时，需同意以下权限： - biz.creator.insights - user.insights.creator - biz.creator.info

达人授权界面:

步骤 3：获取令牌

调用接口 /tt_user/oauth2/token/ 接口。将 grant_type 设置为 authorization_code，并指定 auth_code 和 redirect_uri。在应用设置页的TikTok 账户授权 URL上方，您可以找到开发者应用的 ID 和密钥。

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
--header 'Content-Type: application/json' \
--data-raw '{
 "grant_type" : "authorization_code",
 "auth_code" : "{{auth_code}}",
 "client_secret": "{{client_secret}}",
 "client_id": "{{client_id}}",
 "redirect_uri": "{{redirect_url}}"
}
'
(/code)

API 返回将包含以下信息。请确保您保存了 access_token, open_id 和 refresh_token。 - access_token - scope - expires_in - refresh_token - refresh_token_expires_in - open_id

步骤 4：刷新访问令牌

调用接口 /tt_user/oauth2/refresh_token/ 。使用您在步骤 3 中获取的 refresh_token 来获取一个新的令牌。

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
--header 'Content-Type: application/json' \
--data-raw '{
 "grant_type" : "refresh_token",
 "refresh_token" : "{{refresh_token}}",
 "client_secret": "{{client_secret}}",
 "client_id": "{{client_id}}"
}
'
(/code)

步骤 5：[可选] 撤销访问令牌

如果您希望撤销访问令牌，调用接口 /tt_user/oauth2/revoke/。

示例

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