用途:在启用任何写操作之前,验证 Procore 连接是否真实可用。仅通过只读方式确认身份、公司路由、项目可见性与分页,不创建任何施工记录。
前提:已通过预期授权与环境取得 OAuth 令牌;已知预期公司标识与至少一个已知被允许的项目;已准备脱敏凭证存放位置及权限失败的负责人。
使用步骤:1)冻结目标,记录预期环境、API 基址、公司 ID、令牌别名与应用版本,拒绝生产与沙箱混合输入;2)验证身份,用 Bearer 令牌调用当前用户或公司发现接口,需要公司路由时提供 Procore-Company-Id(多区域与 DMSA 流量尤其如此);3)列出可见项目,使用文档中的项目列表端点和小分页,遵循返回的分页契约而非假设单页完整;4)断言边界,确认已知被允许项目出现、已知不被允许项目不出现,多余可见性应视为安全缺陷而非测试成功;5)留存凭证,记录状态、规范化路由、公司与项目标识、分页元数据、响应延迟及脱敏断言输出的哈希,非必要不保留名称或载荷。
认证:使用为所选 Procore 环境生成的 OAuth 2.0 Bearer 令牌,令牌承载用户权限或 DMSA 权限,冒烟测试不扩大这些权限。
工具纪律:用 Read 与 Grep 检查环境配置和预期标识;仅对已批准测试、断言夹具或脱敏凭证使用 Write/Edit,工作流不得创建、更新或删除 Procore 记录。
输出:环境与身份断言、公司路由与被允许项目断言、分页与负向访问断言,返回通过或失败并指出确切失败边界及无密钥凭证。
错误处理:401 检查令牌过期、环境、吊销与授权头构造;403 或意外 404 检查应用连接、DMSA 权限、被允许项目与已启用工具;项目列表为空先验证公司路由与主体项目成员资格;出现意外项目应停止部署并缩小权限边界。
限制:仅限只读验证;具体接口路径、字段与示例资料未提供完整细节,其他功能暂未提供。