常见问题
本文汇总了OAuth授权的常见问题和常见报错信息。
常见问题
OAuth 授权 URL、授权码到期时间、获取访问令牌接口、访问令牌到期时间是什么？
以下表格列出了 Marketing API 和 TikTok 账号 API、TikTok Creator Marketplace API 中 OAuth 授权 URL、授权码到期时间、获取访问令牌接口、访问令牌到期时间的描述。
xtable
| {18%} | Marketing API{25%}| TikTok 账号 API {27%} |TikTok Creator Marketplace API {30%} |
| --- | --- | --- | --- |
|<b>描述</b>|由 TikTok For Business 广告主完成 Marketing API 的 OAuth 授权。|由 TikTok 原生账号完成 TikTok 账号 API 的 OAuth 授权。 |由 TikTok Creator Marketplace（TTCM）账号和 TikTok 原生账号完成 TTCM API 的 OAuth 授权。<br><br><p><span style="color:darkred"><b>注意</b></span>：[TikTok Creator Marketplace](1763402336271362.html) API 目前处于封闭测试阶段。您需先申请相关白名单。 |
|<b>OAuth 授权 URL</b>|[应用管理](https://ads.tiktok.com/i18n/login?redirect=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fapps%2F)中的广告主授权 URL。欲了解详细步骤，请参考[OAuth授权-第1步](https://ads.tiktok.com/marketing_api/docs?id=1738373141733378)。|[应用管理](https://ads.tiktok.com/i18n/login?redirect=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fapps%2F)中的 TikTok账户授权URL。欲了解详细步骤，请参考[账号-授权](1738083939371009.html)。|<ul><li>TTCM 账号授权：[应用管理](https://ads.tiktok.com/i18n/login?redirect=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fapps%2F)中的广告主授权URL。欲了解详细步骤，请参考[获取 TTCM 账户授权并生成访问令牌](https://business-api.tiktok.com/portal/docs?id=1781189065082881)。</li><li>创作者授权：[应用管理](https://ads.tiktok.com/i18n/login?redirect=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fapps%2F)中的 TikTok 账户授权 URL。欲了解详细步骤，请参考[获取创作者授权 - 第 1 步](1768506960432130.html)。 </li></ul> |
|<b>授权码到期时间</b>|有效期为 1 小时，且仅可使用一次。在`auth_code`到期后，您需要重新进行授权步骤。|有效期为 10 分钟，且仅可使用一次。在`auth_code`到期后，您需要重新进行授权步骤。|<ul><li>TTCM 账号授权码：有效期为 1 小时，且仅可使用一次。</li><li>创作者授权码：有效期为 10 分钟，且仅可使用一次。</li></ul>在`auth_code`到期后，您需要重新进行授权步骤。|
|<b>获取访问令牌接口</b>|[/oauth2/access_token/](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162&rid=dzf5oefhxkk) （广告主访问令牌）| [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)（TikTok 账号访问令牌）| <ul><li>[/oauth2/access_token/](1738373164380162.html) （TTCM 账号访问令牌）</li><li>[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-获取访问令牌)（创作者访问令牌）</li></ul>|
|<b>访问令牌到期时间</b>|广告主访问令牌不会到期。<br><br>若您希望撤销访问令牌，使用[/oauth2/revoke_token/](https://ads.tiktok.com/marketing_api/docs?id=1739965949088770)。|访问令牌的有效期为1天。一旦访问令牌到期，您需要通过 [/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-刷新访问令牌)刷新访问令牌。|<ul><li>TTCM 账号访问令牌：不会到期。若您希望撤销访问令牌，使用[/oauth2/revoke_token/](1739965949088770.html)。</li><li>创作者访问令牌： 有效期为1天。一旦访问令牌到期，您需要通过[/tt_user/oauth2/refresh_token/](https://business-api.tiktok.com/portal/docs?id=1768493902119937#item-link-刷新访问令牌) 刷新访问令牌。</li></ul> |
在哪里能找到开发者应用的密钥?
在TikTok API for Business平台，登陆后进入应用管理， 您可以在基本信息下找到密钥。
当我的广告主重定向至授权链接的回调地址，为什么看不到授权码（auth_code）？
您提供的回调地址被重定向了。例如，ABC.com/auth_code=123 被重定向至 abc.com/。请使用其他地址作为回调地址，或与网站管理员联系以解决这一问题。
在OAuth授权过程中，回调地址的作用是什么?
开发者将授权URL（Authorized URL）发送给广告主之后，广告主在浏览器中输入这个URL。这时会转到一个授权页面，页面上列出了所有开发者想要获得的权限。在点击确定通过授权后，将出现一个新页面。这个页面的地址就是开发者在创建应用时定义的回调地址，加上一些额外的信息。这些额外的信息中，就包含了认证码。认证码部分的格式为 <callback_address>...&auth_code=<auth_code>。
如何设置回调地址?
回调地址必须是一个外联网地址。不能使用局域网地址（比如http://localhost:0001）。您可以使用您公司的主页地址或者其他公开的网站地址。
如果您知道如何解析回调地址来获取认证码，您可以设置一个能够响应的回调地址。在广告主完成授权后，系统将会向这个回调地址发送一个POST请求。您可以设置代码，在收到请求后获取其中的认证码。
如何撤销 TikTok For Business 用户授权给开发者的广告账号访问权限？
若要撤销开发者对广告账户的访问权限，请按照以下步骤操作：
- 若您是广告主（TikTok For Business 用户）并希望取消开发者对您的广告账户的管理权限，请导航至 TikTok For Business 授权设置页面。然后，点击“移除”按钮以撤销您之前授予该开发者的权限。
- 若您是开发者并需要代替广告主取消访问权限，您可以使用/oauth2/revoke_token/接口来撤销与该授权相关联的访问令牌。
常见报错信息
| 常见报错信息 | 报错原因 | 解决方案 |
|---|---|---|
| "Advertiser does not grant you the permission for xxx", where xxxx is an endpoint. | 您发送授权链接的广告主（TikTok for Business用户）没有授予您使用接口的权限。 | 选择您需要的权限，重新获取广告主的授权。欲了解详细步骤，请参考更新应用权限范围和OAuth授权。 |
| 在广告主访问授权URL的时候，页面显示错误信息"Redirect Url Not Match"。 | 授权URL里的redirect_url与开发者应用中的回调地址不一致。 | 确保授权URL中的redirect_url部分与你在开发者应用信息中设置的回调地址一致。 |
| 在广告主完成授权后，重定向的页面显示错误。 | 设置的回调地址并非是一个合法地址，或者是一个局域网地址(例如https://localhost:port_number/)。 | 确保回调地址为合法地址且在公网内可访问。 |
| "Invalid auth code" when getting a long-term access token. | auth_code已过期。本授权码的有效时间为生成后10分钟。 | 需要重新进行授权。将授权URL发送给广告主，让广告主重新批准授权，然后使用新的auth_code来获取访问口令。 |
| "You don't have permission to operate advertiser xxxx" where xxxx is an advertiser ID. "Insufficient advertiser permission: Please ask the BC admin with resource permission to grant access to the advertisers (adv_id:xxxx)." |
授权访问令牌的广告主（TikTok for Business用户）没有访问商务中心中相应广告账户的权限，或者广告主不是广告账户的所有者。 |
|