procore-sdk-patterns

用途：设计一个传输层聚焦的 Procore REST 客户端，保持各端点 API 版本显式，避免通用 JSON 封装抹掉分页限制、公司路由与响应头信息。\n\n主要能力：显式建模请求（HTTP 方法、完整文档化路由、API 版本、company ID、project ID、查询参数、请求体分开表示），拒绝私有或猜测路由；在派发时集中添加 Bearer token 与 Procore-Company-Id，不从缓存数据推断公司路由；向调用方返回 status、解析后的 body、请求关联数据、Link、Total、Per-Page、X-Rate-Limit-* 和 Retry-After；仅对安全读取或具备幂等设计的变更做有界重试，遵守重置/重试头、加入抖动并设置尝试上限；为每个资源适配器提供成功、分页、权限拒绝、校验错误、限流和服务失败的契约 fixture，业务工作流留在传输层之外。\n\n使用方式：客户端从外部 token provider 获取 OAuth 2.0 Bearer token，仅在请求派发时注入，不把 client secret 当普通参数或记录授权头。用 Read 与 Grep 检查现有传输、端点引用与调用点；仅对获批的客户端、适配器、测试或回执使用 Write 或 Edit。输出包括类型化传输与端点适配器边界、分页/限流/错误/脱敏测试、端点版本清单与升级归属，并说明哪些响应契约被保留、哪些端点仍在客户端之外。\n\n限制：需要先枚举公开端点及其当前参考版本。未文档化路由应在本地拒绝，需公司路由的端点缺失公司上下文时在派发前失败；429 或 503 应遵守提供商时间头、排队并在有界策略内重试；变更结果不明确时停止自动重试并先对账。认证细节、具体命令、价格与平台支持资料暂未提供。