用途：在应用内构建一个自有的小型适配器，包裹经过验证的 BambooHR 传输层，把 BambooHR 的模型与错误细节限制在适配器边界内，避免上游 SDK 重新生成或端点迁移影响业务逻辑。
主要能力：选择并封装官方 Python 或 PHP SDK，或使用窄化的直接 HTTP 适配器；为 OAuth 与 API Key 身份提供构造函数而非裸请求头；每个客户端绑定一个已验证的租户子域；将错误归一化为状态、操作、可重试性、请求 ID 与脱敏摘要；保持租户、认证、超时、重试预算与 User-Agent 在客户端实例生命周期内不可变。
当前契约：BambooHR/bhr-api-python 与 BambooHR/bhr-api-php 为官方仓库；bamboohr/api 2.0.1 已发布在 Packagist；Python 仓库记录了 bamboohr-sdk 1.0.0，但公开 PyPI 在 2026-09-11 未暴露该发行版，仓库也无 tag 或 release，应视为源码可见而非注册表已验证；未发现官方 npm BambooHR SDK，TypeScript 集成应使用窄化 HTTP 适配器，不应声称官方包。
使用方式：先用 Read、Glob、Grep 盘点语言、包锁、现有 HTTP 客户端与支持的认证模式；实现时在公共注册表验证所选包；获批的源码安装需固定不可变提交并记录哈希、许可证、来源与更新负责人；定义显式操作如 getCompanyInformation、listEmployees、queryDatasetV2，不向不可信调用方暴露任意 URL 方法；用夹具测试请求构造、租户拒绝、密钥脱敏、类型化错误映射、令牌刷新持久化与响应结构漂移。
限制与边界：添加依赖、使用未发布提交、发起租户请求、扩大 OAuth 范围或围绕 HR 数据启用调试日志前需审批；绝不从 OAuth 静默回退到 API Key；包不在注册表时停止，改为固定源码审查或直接 HTTP；SDK 缺少文档化端点方法时，先核对当前 OpenAPI 再用手工客户端或有界 HTTP 适配器；响应结构漂移时隔离载荷并让契约测试失败。Python SDK 不跨重启存储轮换令牌，需通过调用方拥有的回调持久化。