← 返回目录
📁 Appendix

返回码

TikTok API for Business 返回码是专门用于捕捉您对 TikTok API for Business 接口的调用状态的特殊状态码。若调用失败，可根据这些返回码了解失败原因的相关信息。

TikTok API for Business 接口的调用是否成功，需优先根据 TikTok API for Business 返回码判断，而不能仅查看HTTP 状态码。例如，若返回中 HTTP 状态码显示为200，但返回码为40002，则调用失败，因为此时返回码属于调用失败时返回的返回码。欲了解对于不同 HTTP 状态码的推荐处理方式，请查看HTTP 状态码。

以下表格列出了对于常见返回码的推荐报错处理方式，报错信息示例，以及主要报错原因。若您难以独立处理报错，需要额外帮助，请在 Developer Ticket Platform 提交工单。

调用成功时的返回码

|返回码{30%}|描述{70%}|
|--- |--- |--- |
|0|成功。|
|20001|部分成功。|

调用失败时的返回码

注意

  • 以 5 开头的返回码（例如 51003 ）代表系统服务错误，您可以查看返回信息了解详情。
  • 以下场景可能触发 HTTP 报错 404 page not found （404 未找到网页）：
    • API 方法不正确。例如，接口要求 GET 方法，但您使用了 POST 方法。
    • API 路径不正确。例如，接口路径为/tt_user/oauth2/refresh_token/，但您向 /tt_user/oauth2/refresh_token 发送了请求，路径中缺少了结尾的 / 。

通用返回码

|返回码{30%}|描述{70%}|
|---|---|
| 40000 | 提供参数不正确。 <br><strong>如何处理</strong>：查看API文档，了解参数的正确用法后重试。 |
| 40001 |没有权限进行相关操作。 <br><strong>报错信息示例</strong>：` You don't have permission to operate this catalog: &#123;catalog_id&#125;`. <br><strong>如何处理</strong>：确保您有对应权限重试。欲了解权限的层级，请查看[权限范围](https://ads.tiktok.com/marketing_api/docs?id=1753986142651394)。 |
| 40002 |参数格式错误。详情可参考返回信息。 <br><strong>常见原因</strong>：<ul><li>未传入必传字段。</li><li>字段值格式不正确。</li><li>字段或字段值不支持。</li><li>传入的字段或字段值之间不兼容。</li><li>数据精度不符合规则。</li><li>数字不符合规则。</li><li>受众。<ul><li><strong>报错信息示例</strong>： `Audience is not editable, please check audience status.`</li><li><strong>常见原因</strong>： 1. 创建的受众规模为0（匹配数<1000）。 2. 受众正处于更新或处理状态。</li><li><strong>如何处理</strong>：确保充足的受众规模，检查受众状态，然后重试。</li></ul></li></ul><br><strong>报错信息示例</strong>：` Time format should be %Y-%m-%dT%H:%M. Please try again. ` <br><strong>如何处理</strong>：查看API文档，了解参数的正确用法后重试。 |
|  40006 |所指定的API版本与所传入的参数不兼容。 <br><strong>常见原因</strong>： <ul><li>在所指定的API版本中使用此版本不支持的产品</li><li>指定的API版本不存在</li></ul><strong>报错信息示例</strong>： `The old API version does not support DPA ad. `<br><strong>如何处理</strong>：确保您使用的API版本支持所传入的参数后重试。 |
| 40010 |域在当前API版本中不支持。<br><strong>如何处理</strong>：确保请求URL中的基本URL是正确的（https://business-api.tiktok.com/open_api）后重试。若想了解请求URL的格式，请查看[API参考-请求URL格式](https://ads.tiktok.com/marketing_api/docs?id=1735713875563521#item-link-请求URL格式)。 |
| 40051 |API版本不正确。<br><strong>如何处理</strong>：确保您使用的API版本正确后重试。 |
| 40007 |操作/对象不存在。 <br><strong>常见原因</strong>： <ul><li>指定的对象（推广系列，广告组，广告等）不存在。</li><li>指定的URL已废弃，或指定了不存在的文件。</li></ul><strong>报错信息示例</strong>：`The ad {} does not exist. `<br><strong>如何处理</strong>：确保您需要操作的对象存在，若指定了URL需确保URL有效，随后重试。 |
| 40008 |接口还未启用。<br><strong>常见原因</strong>：<ul><li>使用了不存在的接口。</li><li>在沙箱环境下使用了沙箱环境不支持的接口。</li></ul><strong>如何处理</strong>：确保接口路径正确后重试。在沙箱环境测试时，仅使用支持的接口。您可查看[沙箱账户 - 沙箱账户中支持的接口](https://business-api.tiktok.com/portal/docs?id=1738855331457026#item-link-沙箱账户中支持的接口)了解可用的接口。 |
|  40009 |参数或方法在沙箱账户中不支持。<br><strong>报错信息示例</strong>：`Unsupported data_level in sandbox environment: %s. ` <br><strong>如何处理</strong>：使用沙箱环境中支持的参数重试。 |
| 40011 |请求中包含过多ID。 <br><strong>如何处理</strong>：减少单个请求中包含的ID数，或将ID分批包含在多个请求中，随后重试。 |
| 40013 |沙箱账户不存在。 <br><strong>如何处理</strong>：查看[沙箱账户](https://ads.tiktok.com/marketing_api/docs?id=1738855331457026)文档，了解如何设置沙箱账户，随后重试。 |
| 40014 |所请求的功能，操作或接口不支持在沙箱环境中使用。 <br><strong>如何处理</strong>：请查看[沙箱账户](https://ads.tiktok.com/marketing_api/docs?id=1738855331457026)，了解沙箱环境中支持的功能和接口。 若所请求的功能，操作或接口不支持在沙箱环境中使用，您可在生产环境进行对应测试。 |
| 40050 |重复请求。 |
| 40052 |程序化创意（ACO）素材已存在。  <br><strong>如何处理</strong>：请查看[程序化创意](https://ads.tiktok.com/marketing_api/docs?id=1739470718398465)和[创建程序化创意](https://ads.tiktok.com/marketing_api/docs?id=1745292500427777)，了解程序化创意的介绍，以及创建程序化创意的步骤。 |
| 40053 |视频ID不正确。 <br><strong>如何处理</strong>：确保您使用的视频ID合法后重试。欲获取合法的视频ID，您可调用[/file/video/ad/info/](https://ads.tiktok.com/marketing_api/docs?id=1740050161973250)或[/file/video/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740050472224769)。 |

频控规则或限额相关

|返回码{30%}|描述{70%}|
|---|---|
| 40016|请求过于频繁。 <br><strong>常见原因</strong>：您所使用的接口已触发开发者应用层级的频控限制，因此请求被拒绝。 <br><strong>如何处理</strong>：查看[频控规则](https://ads.tiktok.com/marketing_api/docs?id=1740029171730433)，了解全局频控限制和接口特定频控限制详情。 |
| 40100|请求过于频繁。<br><strong>常见原因</strong>：您所使用的接口已触发开发者应用层级的频控限制，因此请求被拒绝。 <br><strong>如何处理</strong>：查看[频控规则](https://ads.tiktok.com/marketing_api/docs?id=1740029171730433)，了解全局频控限制和接口特定频控限制详情。 |
| 40133|请求过于频繁。<br><strong>常见原因</strong>：您所使用的接口已触发广告主层级的频控限制，因此请求被拒绝。<br><strong>报错信息示例</strong>：`Advertiser (&#123;ID&#125;)'s QPS (&#123;current QPS&#125;) reaches QPS limit &#123;QPS limit&#125; for current path, request is temporarily restricted.` <br><strong>如何处理</strong>：请减少您通过当前广告账号调用该接口的每秒次数。 |
| 40502|达到广告数量上限。 <br><strong>如何处理</strong>：尝试在另一个广告组或推广系列中创建广告，或删除现有广告。 |
| 40132 |您使用某一字段值进行的请求过于频繁。<br><strong>常见原因</strong>：您在使用[/pixel/track/](https://ads.tiktok.com/marketing_api/docs?id=1740858531237890)或[/pixel/batch/](https://ads.tiktok.com/marketing_api/docs?id=1740858565852225)接口传入的`pixel_code`（pixel）值被拒绝，可能是因为：<ul><li>您使用该pixel进行了过多请求，导致该`pixel_code`值被限流，或</li><li>您的访问令牌可能遭到了泄露，被用于恶意攻击 </li></ul> <strong>报错信息示例</strong>： `The request QPS is limited by pixel_code's value.`<br><strong>如何处理</strong>：向报错信息中提到的字段传入新的字段值进行重试，或在[Developer Ticket Platform](https://ads.tiktok.com/athena/requester/boards?identify_key=b25033ef7782d41050cbac74f751d547e9d8ad35a39a541a0f0efbbd51fe722f)提交工单。 |

访问令牌相关

|返回码{30%}|描述{70%}|
|---|---|
| 40110 |授权码错误。 <br><strong>常见原因</strong>：授权码已取消，已使用过或已过期。 <br><strong>报错信息示例</strong>：`The auth_code` is canceled. Please re-authorize and try again with a new auth_code.` <br><strong>如何处理</strong>：使用有效的授权码重试。<br> 欲了解如何获取Marketing API的授权码，请查看[OAuth授权](https://ads.tiktok.com/marketing_api/docs?id=1738373141733378)。<br>欲了解如何获取账号 API 和TikTok Creator Marketplace API的授权码，请分别查看[账号-授权](https://ads.tiktok.com/marketing_api/docs?id=1738083939371009)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
| 40101 |用于生成访问令牌的参数值不正确。<br><strong>常见原因</strong>：<ul><li>密钥和应用 ID 不匹配。</li><li>授权码不合法。</li></ul><strong>报错信息示例</strong>：`Invalid auth_code. Not able to get long-term access_token with an old auth_code. Please retry with the old auth_code.` <br><strong>如何处理</strong>：确保用于生成访问令牌的值正确后重试。 <br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 <br>欲了解如何生成账号 API 和TikTok Creator Marketplace API的访问令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
| 40102 |访问令牌已经过期，需要使用最新访问令牌调用接口。 <br><strong>如何处理</strong>：使用合法的访问令牌重试。 <br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 <br>欲了解如何生成账号 API 和TikTok Creator Marketplace API的访问令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
|40104 |访问令牌为空。 <br><strong>如何处理</strong>：使用合法的访问令牌重试。<br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 <br>欲了解如何生成账号 API 和TikTok Creator Marketplace API的访问令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
| 40105| 访问令牌无效或错误。 <br><strong>如何处理</strong>：使用合法的访问令牌重试。<br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 <br>欲了解如何生成账号 API 和TikTok Creator Marketplace API的访问令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
|40106|核心用户不正确。 <br><strong>如何处理</strong>：确保您使用所指定的广告主ID（`advertiser_id`）对应的合法访问令牌（`Access-Token`）后重试。<br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 |
| 40103|刷新令牌已经过期。 <br><strong>如何处理</strong>：使用合法的刷新令牌重试。欲获取合法的刷新令牌，需请求用户通过用户授权流程重新授权应用权限。<br>欲了解如何生成账号 API 或 TikTok Creator Marketplace API的新访问令牌和刷新令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
| 40107|刷新令牌无效或错误。 <br><strong>常见原因</strong>：<ul><li>试图使用刷新令牌刷新 Marketing API的长期访问令牌。</li><li>使用不合法的刷新令牌。</li></ul><strong>如何处理</strong>：仅使用合法的刷新令牌刷新账号 API 或 TikTok Creator Marketplace API的访问令牌。欲了解Marketing API和账号 API 或 TikTok Creator Marketplace API的访问令牌到期时间差异，请查看[常见问题](https://ads.tiktok.com/marketing_api/docs?id=1766042058952706)。 |
| 40108|授权类型错误。 <br><strong>报错信息示例</strong>：`Invalid value for grant_type: &#123;grant_type&#125; is not supported. `<br><strong>如何处理</strong>：使用正确的`grant_type`值重试。欲了解账号 API 或 TikTok Creator Marketplace API支持的grant_type值，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。|
| 40131|调用`/tt_user/oauth2/token/`或 `/tt_user/oauth2/refresh_token/`时产生的访问令牌相关错误。<br><strong>常见原因</strong>：<ul><li>应用 ID 或密钥不正确。</li><li>授权码已过期。</li><li>刷新令牌无效或已过期。</li></ul><br><strong>报错信息示例</strong>：`"Authorization code is expired."`<br><br><strong>如何处理</strong>：<ul><li>若调用 `/tt_user/oauth2/token/`，需确保使用正确的应用 ID 、密钥或授权码，并重试。  <ul><li> 欲了解如何获取账号 API 和TikTok Creator Marketplace API的授权码，请分别查看[账号-授权](https://ads.tiktok.com/marketing_api/docs?id=1738083939371009)和[Creator Marketplace-获取创作者授权（新）](https://ads.tiktok.com/marketing_api/docs?id=1768506960432130)。</li></ul></li><li>若调用`/tt_user/oauth2/refresh_token/`，需确保使用正确的刷新令牌，并重试。<ul><li>  欲获取合法的刷新令牌，需请求用户通过用户授权流程重新授权应用权限。<br>欲了解如何生成账号 API 或 TikTok Creator Marketplace API的新访问令牌和刷新令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权（新）](https://ads.tiktok.com/marketing_api/docs?id=1768506960432130)。</li></ul></li></ul>
| 40109|解码错误。 |
| 40112|密码错误。 |
| 40113|应用被封禁或者不存在。 <br><strong>常见原因</strong>：<ul><li>应用的 App ID不正确。 </li><li>应用的密钥不正确。</li></ul><strong>报错信息示例</strong>：`The app_id is inconsistent with the token's app information. Please retry after correcting it. `<br><strong>如何处理</strong>：导航至<strong>[应用管理](https://ads.tiktok.com/marketing_api/apps/)</strong> > <strong>App Detail</strong> > <strong>基本信息</strong>，获取<strong>应用ID</strong>和<strong>密钥</strong>。 |
| 40115|授权时间戳已过期。<br><strong>常见原因</strong>：<ul><li>授权码不正确。</li><li>调用的访问令牌接口与传入的授权码不匹配。</li></ul><strong>如何处理</strong>：确保用于生成访问令牌的值正确后重试。 <br>欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 <br>欲了解如何生成账号 API 和TikTok Creator Marketplace API的访问令牌，请分别查看[账号-获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738084387220481)和[Creator Marketplace-获取创作者授权](https://ads.tiktok.com/marketing_api/docs?id=1740027719016450)。 |
| 40116|授权签名错误。 |
| 40117|方法无法使用。 |
| 40118|当前应用或广告主不在允许列表里。 <br><strong>常见原因</strong>： <ul><li>该功能只向特定国家或地区的广告主开放。</li><li>该接口为白名单功能，您还未申请对应白名单。</li></ul>|
| 40119|开发者和广告主公司主体不一致。 <br><strong>如何处理</strong>：确保您使用所指定的广告主ID（`advertiser_id`）对应的合法访问令牌（`Access-Token`）后重试。欲了解如何生成Marketing API的访问令牌，请查看[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)。 |
| 40121|TikTok 用户非TCM （TikTok Creator Marketplace）达人。<br><strong>常见原因</strong>：本接口要求传入TCM创作者的信息，例如用户名，但您传入了非TCM创作者的信息。 <br><strong>如何处理</strong>：传入TCM创作者的信息，或要求该未加入TCM的创作者加入TCM后重试。欲了解邀请创作者加入TCM的详细步骤，请查看[邀请创作者加入TTCM](https://ads.tiktok.com/marketing_api/docs?id=1740027740710914)。 |
| 40122|TCM 创作者未在有效地区。 <br><strong>如何处理</strong>：提供其他国家或地区的TCM创作者信息进行重试。 |
| 40124|开发者个人资料未填写完或未通过审核。 <br><strong>如何处理</strong>：访问https://ads.tiktok.com/marketing_api/developer/register ，完善个人资料。个人资料通过审核后重试。<br>若您个人资料过审困难，请在 [Developer Ticket Platform](https://ads.tiktok.com/athena/requester/boards?identify_key=b25033ef7782d41050cbac74f751d547e9d8ad35a39a541a0f0efbbd51fe722f) 提交工单。 |
| 40125|开发者无权限。 <br><strong>常见原因</strong>：<ul><li>缺少必要权限。</li><li>使用未支持的字段。</li></ul><strong>如何处理</strong>：确保您有必要权限且使用已支持的字段后重试。欲了解权限的层级，请查看[权限范围](https://ads.tiktok.com/marketing_api/docs?id=1753986142651394)。 |
| 41001|接口已下线。 <br><strong>如何处理</strong>：确保接口路径正确，且与指定的API版本匹配后重试。 |
| 41002|部分传入字段已废弃。 <br><strong>如何处理</strong>：查看API文档，了解参数的正确用法后重试。 |

广告政策相关

|返回码{30%}|描述{70%}|
|---|---|
|40065|使用了与美国 13-17 年龄区间定向不兼容的定向设置。<br><br><strong>报错信息示例</strong>：`"Based on one or more of your choices, ad delivery to `US` audiences will be subject to age targeting restrictions"`<br><br><strong>如何处理</strong>：<ul><li>若您想要定向美国 13-17 年龄区间，需确保您仅使用支持的定向设置后重试。若想了解此场景下支持的定向设置，请查看 [TikTok 广告的新增年龄定向限制](1788755983247362.html)。</li><li>若您不想定向美国 13-17 年龄区间，请手动指定 `age_groups` 字段的值，且确保值中不包含`AGE_13_17`后重试。</li></ul> |

异步任务错误

|返回码{30%}|描述{70%}|
|---|---|
|40200|任务错误。<br><strong>如何处理</strong>：查看API文档，了解参数的正确用法后重试。|
|40201|任务未完成。<br><strong>如何处理</strong>：等待任务完成后重试。|

程序运行错误

|返回码{30%}|描述{70%}|
|---|---|
|40202|写入或更新冲突。<br><strong>如何处理</strong>：重试可能解决此问题。 |

广告主

|返回码{30%}|描述{70%}|
|---|---|
| 40300|广告主不存在或者已经被删除。 <br><strong>常见原因</strong>： 广告主ID（`advertiser_id`）不正确。 <br><strong>如何处理</strong>：使用正确的广告主ID重试。 |
| 40301|无法匹配到对应广告主。 <br><strong>常见原因</strong>： 广告主ID（`advertiser_id`）不正确。 <br><strong>如何处理</strong>：使用正确的广告主ID重试。 |

内部服务错误

|返回码{30%}|描述{70%}|
|---|---|
|40700|内部服务验证失败。<br><strong>如何处理</strong>：查看API文档，了解参数的正确用法后重试。|

文件管理相关

|返回码{30%}|描述{70%}|
|---|---|
|40901| 视频转码中。 <br><strong>如何处理</strong>：等待视频转码完成后重试。 |
| 40902|无法抓取URL。 <br><strong>如何处理</strong>：重试可能解决此问题。 |
| 40903|图片URL失效。 <br><strong>如何处理</strong>：重试可能解决此问题。 |
| 40913|无法抓取图片。 <br><strong>如何处理</strong>：重试可能解决此问题。 |
| 40905|文件不存在。 <br><strong>如何处理</strong>：提供正确的文件路径或URL重试。 |
|  40906|文件为空。 <br><strong>如何处理</strong>：提供正确的文件路径或URL重试。 |
|  40907|文件过大。 <br><strong>如何处理</strong>：减小文件大小后重试。 |
|  40910|文件已过期。 <br><strong>如何处理</strong>：提供正确的文件路径或URL重试。 |
|  40914|想要上传的文件不合法。 <br><strong>如何处理</strong>：提供正确的文件路径或URL重试。 |
|  40908|文件类型不支持。 <br><strong>如何处理</strong>：确保使用正确的文件类型后重试 |
|  40900|文件签名错误。 <br><strong>常见原因</strong>：所传入的图片，视频或音乐的签名不正确。 <br><strong>如何处理</strong>：确保提供的签名与文件匹配后重试。 |
|  40909|加密类型（`calculate_type`）不支持。<br><strong>如何处理</strong>：确保 `calculate_type` 的值正确后重试。 |
|  40911|素材重名。 <br><strong>如何处理</strong>：为素材指定另一个名字后重试。您可以使用[/file/name/check/](https://ads.tiktok.com/marketing_api/docs?id=1759130033155073)检查图片或视频的文件名是否与现有的图片或视频重名。 |
| 40904| 非法的图片内容。 <br><strong>常见原因</strong>：图片格式不支持。 <br><strong>如何处理</strong>：确保使用支持的图片格式后重试。 |
|  40912|图片URL失效。 <br><strong>如何处理</strong>：确保您使用的图片URL合法后重试。欲获取合法的图片URL，您可以使用[/file/image/ad/info/](https://ads.tiktok.com/marketing_api/docs?id=1740051721711618)或[/file/image/ad/search/](https://ads.tiktok.com/marketing_api/docs?id=1740052016789506)。 |
|  40915|上传的文件不符合规则。<br><strong>如何处理</strong>：确保您上传的文件符合接口特定的要求后重试。|

访问受限

|返回码{30%}|描述{70%}|
|---|---|
|41000|您的IP位于禁止国家列表中。|

系统相关

|返回码{30%}|描述{70%}|
|---|---|
|50000|系统错误。|
|50002| TikTok平台处理请求发生错误。详情可参考返回信息。|
|51305|卫星服务错误。|

维护中

|返回码{30%}|描述{70%}|
|---|---|
|60001|系统维护中。<br><strong>如何处理</strong>：请等待维护结束后重试。|

TikTok Creator Marketplace

欲了解更多信息，请参考错误码。

← 枚举值HTTP状态码 →

内容来源：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 每日平台更新简报 →