← 返回目录
📁 Marketing API › Get started

OAuth 授权

使用 Marketing API 前,您(即开发者)需要从广告主获取管理他们账户的授权。

前提条件

步骤

  1. 在 TikTok API For Business 平台, 选择应用管理,然后点击您想要获取授权的应用。在基本信息部分,找到广告主授权 URL,并将它发送给您的广告主。

注意
您可以配置最多 10 个广告主重定向 URL,包括 localhost。一旦添加了新的重定向 URL,您可以生成一个新的广告主授权 URL。

广告主授权 URL

  1. 广告主在浏览器里输入授权 URL。之后会跳转到一个授权页面,页面上显示了您申请的权限列表。

权限列表

  1. 广告主查看您所申请的权限,同意平台服务条款,然后点击确定。

  2. 广告主点击发送验证码,将验证通知发送到与广告账户绑定的邮箱地址。

发送验证码

  1. 广告主通过输入验证码并点击确定来验证其身份。

注意
- 广告账户授权某一开发者应用的身份验证在 48 小时内有效。在此期间,来自同一开发者应用的重复授权请求不需要额外验证。 - 如果广告账户试图授权另一开发者应用,则需要重新进行身份验证。

确定

注意
若系统识别到您的账户存在异常行为,将会出现一条授权失败的弹出消息。请稍后再试。若您对本次授权请求无异议,请在 Developer Ticket Platform 提交工单进行人工审核。

  1. 验证通过后,广告主会跳转到一个新页面。这个页面的地址就是您在申请开发者应用时候定义的广告商重定向URL。该URL后面附加了授权码。

示例:https://business-api.tiktok.com/portal/docs?state=your_custom_params&code=3c6dc21d2db289199737bcb8c006c23aaf000a1e&auth_code=1234c21d2db289199737bcb8c006c23aaf000a1e&id=1701890905779201

  1. 开发者应配置一个服务器端接口,该接口地址与指定的 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,您的服务器端接口应能够提取此参数值并将其安全地存储或处理,从而使用其生成访问令牌。

  2. 获取授权码后,开发者可以调用/oauth2/access_token/接口来获取一个长期访问令牌。在请求中,开发者还需要传入开发者应用的app_id 和 secret。

重要
授权码(auth_code)有效时间为 1 小时,且仅可使用一次。过期后,您需要重新进行授权流程来获取一个新的授权码。

下一步

获取访问令牌

常见问题/常见报错信息

欲了解详细信息,请参考OAuth授权-常见问题。

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →