SuperAPI AI 工具集

procore-common-errors

编程与开发

查看项目

更新于 10-15 23:28

技能介绍

用途:对 Procore 集成故障进行分层分类与窄范围恢复,覆盖 OAuth、公司路由、权限、接口契约、业务校验、分页、限流和 Webhook 失败。

主要能力:按状态码归类根因——401 指向令牌或环境,403 指向连接、权限、工具或项目范围,404 指向路由、标识符或隐藏访问,422 指向业务校验,429 指向速率预算,5xx 指向服务方或临时基础设施;检查公司路由与 Procore-Company-Id 是否必需;核对公开接口契约、API 版本、必填字段、过滤器、已启用工具与项目成员关系;仅在证据充分时做窄范围恢复。

使用方式:先保留失败现场(响应码、响应头、响应体结构、关联数据、耗时,并脱敏授权、目标头、查询密钥、名称与构造负载);再分类层级;检查公司路由,审计可能丢失显式路由上下文的后台任务与 Webhook 处理器;对照当前文档确认路由与契约,拒绝私有或已弃用端点;恢复时仅对身份失败刷新或重新授权,仅在证据证明缺失权限时修权限,遵守速率响应头,仅在操作安全时重试服务端错误;最后用最小脱敏用例回放验证,并监控 Integration Health 或 API 活动。

限制:使用现有 OAuth 2.0 Bearer 令牌别名,不请求更宽权限令牌;授权码与 DMSA 主体保持原有权限模型;仅用 Read 与 Grep 检查日志、适配器、清单与提供方契约,Write 或 Edit 仅用于已批准的修复、回归测试或脱敏回执,不得存储令牌或复制原始客户负载。证据缺失原始响应时先复现一次受限请求;429 时遵守 X-Rate-Limit-Reset、排队并加抖动;超时后写入状态不明时先对账再重试;未知或私有路由应停止并替换为文档化公开端点或联系 Procore API 支持。