OAuth 授权
使用 Marketing API 前,您(即开发者)需要从广告主获取管理他们账户的授权。
前提条件
- 已创建 TikTok For Business 账号。欲了解更多详情,请查看创建TikTok For Business账号。
- 已注册成为开发者。欲了解更多详情,请查看注册成为开发者。
- 已创建开发者应用。欲了解更多详情,请查看创建开发者应用。
步骤
- 在 TikTok API For Business 平台, 选择应用管理,然后点击您想要获取授权的应用。在基本信息部分,找到广告主授权 URL,并将它发送给您的广告主。
注意
您可以配置最多 10 个广告主重定向 URL,包括 localhost。一旦添加了新的重定向 URL,您可以生成一个新的广告主授权 URL。
- 广告主在浏览器里输入授权 URL。之后会跳转到一个授权页面,页面上显示了您申请的权限列表。
-
广告主查看您所申请的权限,同意平台服务条款,然后点击确定。
-
广告主点击发送验证码,将验证通知发送到与广告账户绑定的邮箱地址。
- 广告主通过输入验证码并点击确定来验证其身份。
注意
- 广告账户授权某一开发者应用的身份验证在 48 小时内有效。在此期间,来自同一开发者应用的重复授权请求不需要额外验证。 - 如果广告账户试图授权另一开发者应用,则需要重新进行身份验证。
注意
若系统识别到您的账户存在异常行为,将会出现一条授权失败的弹出消息。请稍后再试。若您对本次授权请求无异议,请在 Developer Ticket Platform 提交工单进行人工审核。
- 验证通过后,广告主会跳转到一个新页面。这个页面的地址就是您在申请开发者应用时候定义的广告商重定向URL。该URL后面附加了授权码。
示例:https://business-api.tiktok.com/portal/docs?state=your_custom_params&code=3c6dc21d2db289199737bcb8c006c23aaf000a1e&auth_code=1234c21d2db289199737bcb8c006c23aaf000a1e&id=1701890905779201
-
开发者应配置一个服务器端接口,该接口地址与指定的
redirect_uri相匹配。该接口将从重定向 URL 的查询参数中接收授权码(auth_code)。
例如,如果重定向 URL 为https://business-api.tiktok.com/portal/docs?state=your_custom_params&code=3c6dc21d2db289199737bcb8c006c23aaf000a1e&auth_code=1234c21d2db289199737bcb8c006c23aaf000a1e&id=1701890905779201,您的接口应能够从接收的 URL 中提取授权码。
在此示例中,code参数的值为:1234c21d2db289199737bcb8c006c23aaf000a1e,您的服务器端接口应能够提取此参数值并将其安全地存储或处理,从而使用其生成访问令牌。 -
获取授权码后,开发者可以调用/oauth2/access_token/接口来获取一个长期访问令牌。在请求中,开发者还需要传入开发者应用的
app_id和secret。
重要
授权码(auth_code)有效时间为 1 小时,且仅可使用一次。过期后,您需要重新进行授权流程来获取一个新的授权码。
下一步
常见问题/常见报错信息
欲了解详细信息,请参考OAuth授权-常见问题。