故障排查

先确认具体工作区、渠道、内容和大致时间，并保留页面或 API 返回的请求 ID。不要分享 API Key、社交 Token、Webhook Secret、Session Cookie 或一次性验证码。

连接时找不到账号

1. 确认已登录正确的社交账号。
2. 检查原生平台角色是否能管理并发布到目标主页、账号、频道或门店。
3. 确认平台支持该账号类型和地区。
4. 重新授权，并授予目标功能需要的权限。

已连接渠道出现认证错误时，BlendDuck 会先把它移出新发布流程并自动恢复。如果平台授权或原生账号角色发生变化，请再次使用正常的连接渠道流程。

身份核对与失败目标保护规则请查看渠道自动恢复。

内容无法排期

• 修复每个目标的全部阻断性验证错误。
• 确认发布时间在未来，并检查页面时区。
• 检查媒体类型、大小、比例、时长和平台专属字段。
• 如果要求审批，提交当前版本并等待全部阶段通过。
• 确认渠道仍然已连接，并支持所选内容类型。

修改内容或审批策略会使旧版本审批失效，需要重新提交。

排期目标发布失败

从日历打开内容，检查失败的具体目标。认证和权限错误通常需要重新连接；验证错误需要修改内容或媒体；限流错误必须等待页面给出的时间。

在确认平台是否接收第一次请求前，不要创建重复内容。BlendDuck 会保存目标状态和幂等信息，以便安全重试。

Inbox 或 Analytics 没有数据

• 确认渠道提供目标能力。
• 检查日期范围、状态、渠道和活动筛选。
• 查看最近同步状态；授权失败时重新连接。
• 平台数据可能延迟；不支持的指标会保持不可用，不会被估算。

API 返回 401 或 403

• 401：Bearer 凭据缺失、无效、过期或已撤销。
• 403：Key 有效，但缺少所需 Scope 或组织权限。

只通过 Authorization: Bearer ... 发送 Key。组织 API Key 不能放入浏览器代码；可能泄露时立即轮换。

API 返回 409、422 或 429

• 409：资源状态或幂等冲突。重试前先读取当前资源。
• 422：JSON 有效，但字段或平台设置不合法。根据 error.details 修复。
• 429：达到配额或限流。遵守 Retry-After 和 RateLimit-* 响应头。

联系支持时，请提供请求 ID、HTTP 方法和路径、状态码及脱敏后的输入结构，不要附带 Authorization Header 或原始客户内容。

订阅和结账问题请按照账单与订阅指南单独处理。