用途:为 Procore 集成建立确定性的开发循环,把快速的 fixture 测试与谨慎的提供商测试分开,在 Developer Sandbox 中验证适配器行为。
主要能力:按步骤定义端点契约(方法、规范化路由、必需请求头、请求模式、预期状态、分页元数据、错误结构),并让提供商生成的 ID 不进入黄金断言;用离线 fixture 覆盖令牌过期、权限拒绝、隐藏资源 404、校验失败、限流和服务器重试,并断言密钥与构造负载被脱敏;把真实测试隔离到 login-sandbox.procore.com 与 sandbox.procore.com,仅用沙盒凭据,本地和 CI 测试配置拒绝生产主机;创建有界数据时给测试产物加运行标识前缀、记录每个创建的 ID,并按依赖倒序清理;当官方端点行为变化时先看 API 参考和变更日志、更新适配器,再有意识地只重录脱敏 fixture。
使用方式:先用 Read 与 Grep 检查代码、fixture 和端点文档;仅在已批准的适配器、fixture、测试、清理清单或回执上使用 Write 或 Edit;提供商变更必须带仅沙盒保护和清理路径。真实沙盒测试使用沙盒 OAuth 2.0 Bearer token,开发配置禁止生产凭据与令牌。
适用场景:开发 Procore 端点适配器、离线回放 401/403/404/422/429 等 fixture、在沙盒中创建一个带前缀的 RFI 并验证响应结构后清理。
限制:Developer Sandbox 不是生产副本,不能随意刷新,测试必须自己拥有并清理记录;fixture 中不得包含凭据或令牌。检测到生产主机时应在获取令牌或构造请求前失败关闭;fixture 漂移时先对照当前端点参考与变更日志;清理失败时保留精确资源 ID 并指派沙盒清理负责人;fixture 出现密钥时隔离该产物、必要时轮换并替换为合成值。其他细节暂未提供。