错误码

平台接口错误通常会返回错误码和提示文案。不同模块的业务错误可能有差异，以下是通用理解方式。

常见类型

• BAD_REQUEST：请求参数不完整或格式不正确。
• UNAUTHORIZED：未登录或登录状态失效。
• FORBIDDEN：当前账号无权限访问该资源。
• NOT_FOUND：资源不存在，或资源不属于当前账号。
• LIMIT_EXCEEDED：套餐额度不足或超过限制。
• INTERNAL_ERROR：服务端处理异常。

处理建议

• 参数错误：检查输入是否为空、URL 是否有效、是否选择了品牌项目。
• 登录错误：重新登录后再试。
• 权限错误：确认当前账号、项目和角色。
• 资源不存在：检查链接、项目切换和资源 ID。
• 额度错误：减少配置数量或升级套餐。
• 服务异常：保留错误信息和发生时间，联系支持。

提交给支持的信息

排障时建议提供：

• 错误码。
• 页面路径。
• 当前品牌项目。
• 操作时间。
• 任务 ID、报告 ID 或文章 ID。
• 截图或错误提示原文。

注意

部分第三方平台会返回自己的错误码，例如 AI 平台、SEO 数据源或浏览器采集端错误。此类错误需要结合具体模块日志判断。