用途:在修改代码或凭据前,先对 Attio 接口失败进行归类,避免盲目排查。诊断过程保留响应的结构化字段,同时确保令牌和 CRM 数据不出现在诊断信息中。
主要能力与依据:Attio 错误响应可能包含 status_code、type、code、message 等字段,应基于实际观察到的字段判断,而不是套用固定错误码清单;端点文档才是请求结构与所需权限范围的权威依据。需要掌握的信息包括 HTTP 方法、路径模板、状态码、脱敏后的响应体、端点文档要求的作用域、分页模式与变更语义,以及可用的关联请求标识。
典型判断:400/422 偏向请求体或属性值校验,对照端点文档检查;401 为令牌缺失或无效,检查凭据注入但不打印令牌;403 为权限不足,比对所需作用域;404 为资源标识错误,解析当前对象、列表、记录或条目 ID;409 为唯一性冲突;429 为限流,按 Retry-After(HTTP 日期)等待后再重试;5xx 为提供方或瞬态故障,限制重试次数并保留脱敏证据。
使用方式:用 Read、Glob、Grep 定位调用方、响应解析、重试策略与日志;仅在需要最新官方文档时使用 WebFetch;在确认失败契约与安全验证路径后再使用 Write 或 Edit。对不确定的资源身份,先用只读发现请求确认;对模糊的 5xx,保留最小复现并在改动业务逻辑前查 Attio 状态。
限制与注意事项:非 JSON 响应应保留状态码与内容类型,不要强制按 JSON 解析;证据中出现令牌必须立即停止并脱敏;永久性 4xx 不应继续重试。在缺少负责人和恢复方案时,不得扩大作用域、轮换共享生产凭据、重放语义不明确的变更请求或暴露客户数据。部分具体信息(如官方链接细节)资料未提供。