错误处理

先看 envelope

APIMUX 响应采用 success-or-error envelope。请求失败时，先读错误对象，再决定是否重试或修改参数。

如果你在用 CLI，需要完整响应结构时请加 --debug：

apimux --debug amazon get_product --asin B0CM5JV26D --market US

常见恢复方式

• 认证失败：检查 bearer token 或 CLI 配置
• 参数校验失败：查看 capability schema，修正请求结构
• 上游超时或 provider 不可用：带退避重试
• 触发限流：降低频率后再试

部分成功

有些 capability 会在部分上游失败时仍返回可用数据。做自动化或 Agent 集成时，不要在未检查 metadata 的情况下，把缺失的子结果直接当作 0 或默认空值。

以哪里为准

精确的响应模型、错误 schema 和 capability 请求结构请查看：

• /settings/api-docs
• GET /v1/schema/{capability}
• apimux schema show <capability>