错误

出现问题时，我们的错误消息通常采用以下格式，以便更容易定位问题。

[问题类别] 错误类型 - 详情（请求 ID）

• 问题类别描述问题发生的位置。
• 错误类型描述问题的类型。
• 详情提供有关具体问题的更多信息，以及如何修复的建议。
• 请求 ID是我们用于跟踪对 Ahrefs API 发起调用的标识符。

如果您无法自行解决问题，请在联系支持团队时提供以下信息。

• 一张截图，显示出现问题的图表所使用的字段、日期范围、参数和过滤器。
• 另外，如果图表显示错误，请一并提供请求 ID 和错误消息。

问题类别

连接器配置问题

由于数据源配置无效而导致问题。请使用有效设置重新连接数据源。

图表问题

数据源配置正确，但在创建图表时使用不当导致出现问题。错误详情会提供更多信息，说明需要在图表属性面板中更改哪些内容。

访问问题

用于授权的 Ahrefs 账号权限不足，无法使用该连接器。如果您遇到此错误，但已订阅可访问已配置 Ahrefs 项目的受支持套餐，请携带请求 ID 联系我们的支持团队。

Ahrefs API 问题

Ahrefs API 出现异常。请查看您的 Ahrefs 控制台了解状态更新，或携带请求 ID 联系我们的支持团队。

错误类型

缺少/无效的配置参数

未提供必需的配置参数值，或提供的值不符合预期格式。您可以通过重新连接数据源在全局范围内提供有效值，也可以在报告中通过覆盖参数在本地提供有效值。

请注意，每个 Ahrefs 字段组可能会对有效配置的定义施加额外限制。因此，即使数据源配置在全局范围内有效，在构建图表时仍可能出现此错误。

无效的字段组合

请求了无效的字段组合。为便于使用，我们的连接器将来自多个来源的字段归类为 Ahrefs 报告类型，因此并非所有字段都彼此兼容。每个连接器的字段参考资料会说明哪些字段可以一起请求。

更多信息，请参阅字段分类。

无效的日期范围

请求了无效的日期范围。这可能是因为我们某些连接器的字段组会以特殊方式处理日期范围。

日期范围参考资料会说明每个字段组如何使用日期范围参数。

更多信息，请参阅日期范围用法。

不支持的过滤器

应用了使用不支持的运算符的过滤器。

目前，我们不支持“Regex contains”过滤器运算符。

未知字段

请求了某个字段（作为维度、指标或过滤条件表达式的一部分），但 Ahrefs API 无法识别其标识符。这意味着数据源与 Ahrefs API 的状态已不同步。通常可以通过刷新数据源字段来解决。但请注意，这可能会导致使用该数据源的现有报告出现问题。