用途:以最小且低敏感度的调用验证 BambooHR 租户连接,确认路由、TLS、认证与基础权限,避免一开始就访问含个人数据的员工目录。
主要能力:使用租户本地主机 https://company-subdomain.bamboohr.com,调用官方 OpenAPI 操作 GET /api/v1/company_information 获取基础公司资料,支持 OAuth 或 API Key 认证。输出 PASS/FAIL 回执,包含租户别名、端点类别、认证方式、状态码、延迟、请求 ID、脱敏确认与下一步窄范围测试。
使用方式:先确认租户子域与认证模式,子域输入中拒绝斜杠、协议、端口和点号;检查项目是否已有 BambooHR 客户端并复用其超时、User-Agent、请求 ID 与脱敏控制。经操作者批准后,可运行丢弃响应体的冒烟测试:
curl --fail-with-body --silent --show-error
--max-time 20 --output /dev/null --write-out '%{http_code}\n'
--user "${BAMBOOHR_API_KEY}:x"
"https://${BAMBOOHR_COMPANY_SUBDOMAIN}.bamboohr.com/api/v1/company_information"
OAuth 场景由应用内具备密钥感知的 HTTP 客户端发送 Authorization: Bearer,避免令牌进入 shell 历史。记录时间戳、租户别名、认证模式、HTTP 状态、耗时与服务器请求 ID,不保留响应体。连接验证成功后再申请员工范围测试,并显式最小化字段列表。
适用场景:集成起步、主机或认证问题隔离、权限基础确认。
限制:未获明确批准不得发起实时请求、访问员工端点、安装包或写入凭据;实时请求仅限 HTTPS、单一只读公司信息端点、有限超时且不保留响应体。200 仅证明该身份可执行此操作,不代表更广权限。错误处理:DNS/TLS 失败检查子域与信任链;401 校验凭据类型与时效且不打印;403 表示身份缺少该操作,不得静默提权;429、504、598 报告瞬时状况并交由重试技能处理。工具纪律:用 Read、Glob、Grep 查找现有客户端与配置约定,Write/Edit 仅添加已批准示例或测试,Bash 限 curl 且执行前展示确切主机与响应体保留行为。