SuperAPI AI 工具集

salesloft-common-errors

测试与质量

查看项目

更新于 10-15 23:29

技能介绍

用途:这是一个 Salesloft API 错误分类与排查技能,目标是在改动代码、权限范围或凭据之前先识别出真正失败的契约,并在保留结构化错误含义的同时排除敏感信息。

主要能力:按认证、权限/可见性、资源缺失、校验、速率、传输、提供商等类别对失败分类。依据当前文档契约识别响应结构:成功数据位于 data,列表元数据位于 metadata;403 与 404 使用单数错误对象;422 使用按字段键组织的 errors 对象,可报告多条校验失败;429 需结合 x-ratelimit-endpoint-cost 与 x-ratelimit-remaining-minute 及实际返回的重试指引评估。

使用方式:先用 Read、Glob、Grep 追踪请求构造与响应处理;仅在需要确切官方 Salesloft 契约时使用 WebFetch;在失败类别有证据支持后再用 Write 或 Edit。排查步骤包括:脱敏后复现一次、确认 base URL/method/path/内容类型/查询编码/超时、分类失败、比对端点所需 scope 与允许参数、做最小修正并先跑只读或 fixture 验证。写操作需载荷批准与写后读验证。

前置信息:method、path 模板、状态、时间戳、团队别名;脱敏后的请求形态与响应内容类型;认证流程、授予的 scope 与操作用户角色;速率头与尝试次数(若有)。

限制与边界:不得捕获访问令牌、刷新令牌、client secret、API key 或授权码;不得轮换凭据、扩大 scope、改动生产数据,或仅为验证假设而重试不确定的写操作。无法安全复现时应升级处理。输出为脱敏症状、证据、失败类别、最小可行修正、安全验证与升级负责人。示例输出:status=422; class=validation; fields=email_address; secrets=redacted; retry=no