用途:围绕应用实际调用的 Salesloft 接口构建一个范围收敛的客户端,避免发明通用模式、隐式租户状态和无上限的递归重试。
主要能力:梳理端点、作用域、请求与响应格式清单;定义成功、列表元数据、单条错误、校验错误与速率状态等类型模型;集中处理超时、Bearer 注入、内容协商与脱敏错误捕获;实现迭代式分页器;对安全操作或有明确幂等性的流程做有界重试。
使用方式:需先有明确 HTTP 边界的仓库、端点与格式清单、租户到凭证的解析器,以及成功/失败信封的夹具覆盖。用 Read、Glob、Grep 检查包版本、调用点与生成类型;WebFetch 仅用于官方端点契约;确认适配器边界后再用 Write 或 Edit。契约方面使用 https://api.salesloft.com/v2 及文档化资源路径,不要给每个路径强制加 .json;保留 data、metadata、error 与按字段键控的错误为独立类型;分页与过滤按端点而定,页码从 1 开始,深页消耗更多速率成本;从响应中捕获 x-ratelimit-endpoint-cost 与 x-ratelimit-remaining-minute;按端点文档说明的请求内容类型写入。鉴权上每次调用都从显式租户上下文解析 Bearer 凭证,不使用可变全局令牌,不用其他租户凭证重试。错误处理:401 按配置流程刷新一次;403/404 保留单条错误并核对作用域、可见性与路径;422 保留字段级错误,不抹平字段上下文;429/5xx 依据当前响应头做有界退避,并暴露耗尽情况。
适用场景:需要将 Salesloft 调用收敛到统一适配层、统一鉴权与分页、控制限流与重试的后端或集成项目。
限制:禁止从示例臆造请求字段、自动回退到 v1,或在无应用幂等规则与操作者批准下重试 CRM 写入。输出应返回端点清单、类型边界、鉴权解析器、分页行为、重试策略、夹具覆盖与仍存在的直接调用。未提供具体安装命令、价格与官方文档细节。