SuperAPI AI 工具集

instantly-common-errors

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:把一次观察到的 Instantly API v2 失败,转化为有边界的诊断和可验证的纠正动作,并记录假设、证据、审批状态与回滚责任人,便于他人复现。

主要能力:区分认证、授权、支付、校验、资源缺失、冲突与限流失败;核对实时端点文档与所需权限范围;在可能时用合成的只读请求复现;应用最小配置或代码修正;记录证据并在破坏性重试前停止。

关键契约:401 表示授权缺失、无效或已撤销;403 表示密钥缺少所需 scope;429 默认作用于整个工作区,除非端点发布更严格覆盖;API 错误暴露 statusCode、error、message,不能仅凭 JSON 正文推断成功。

使用方式:使用 API v2 密钥,以 Authorization: Bearer <key> 访问 https://api.instantly.ai/api/v2;只授予端点特定所需 scope,从批准的服务器端密钥管理器注入,绝不打印、持久化、提交或放入 URL。用 Read、Glob、Grep 检查代码与配置;WebFetch 仅用于 Instantly 一方文档与包元数据;仅在明确要求实现且目标文件已知时使用 Write 或 Edit。

限制与审批边界:未经责任人明确批准,不得创建、轮换、泄露或撤销密钥,邀请或移除成员,跨工作区委派,连接发信账户,创建或激活活动,导入或删除线索,更改抑制或保留策略,注册、修补、恢复或删除 webhook,调整套餐或付费容量,传输诊断信息或执行其他生产变更。诊断默认只读。

输出:返回工作区安全范围、检查的文件与契约、确切的 API v2 路由与所需 scope、收集的证据、校验结果、已脱敏的敏感字段、剩余风险、责任人、审批状态以及回滚或下一步动作。

错误处理:401 停止并核实 bearer 密钥存在、有效且未被撤销;403 停止并对照操作所需确切 scope,不要默认扩大到 all:all;429 协调工作区预算、遵守端点覆盖并限制重试;schema 或租户不匹配时失败关闭,保留脱敏证据,不重试变更操作。