容易访问。容易修改。

Bamboohr API是一个恢复的互联网协议，其围绕制作语义有意义的HTTPS请求来访问或修改资源（通常由员工完成）。API可用于操纵员工数据并以多种格式生成报告。

永远不要错过任何东西！

注册我们的邮件列表以在有计划更改或添加到API添加时接收更新。我们可能偶尔会为您的输入伸出援手！

在此注册：//www.vietgest.com/api-mailing-list/

你需要什么来开始呢?

• 要编写代码的软件开发人员
• 一个HTTP客户端:
  • 这个图书馆可以帮助您开始：https://documentation.bamboohr.com/docs/language-bindings.
  • 邮递员。

如果您是客户或正在为单个BambooHR客户构建集成:

• BambooHR账户
• 子域用于访问您的帐户（如果您访问竹子https://mycompany.bamboohr.com.，那么子域是“mycompany”）
• API键（见身份验证下面有关获得API键的说明）

如果你正在为多个客户构建一个集成:

• 申请在这里获得客户ID和秘密
• 询问相互客户的竹子子域
• 用Openid Connect.获取BambooHR用户的API密钥

身份验证

每个从第三方应用程序发送到BambooHR网站的API请求都将被验证和授权，就像一个真正的用户正在使用该软件一样。与API请求相关联的用户的权限将决定每个API请求允许查看和/或编辑哪些字段和员工。

要生成API密钥，用户应登录并单击任何页面的右上角的名称以获取用户上下文菜单。如果它们具有足够的权限，则在该菜单中将有一个“API键”选项以转到页面。

每个用户可能有一个或多个秘密的API密钥，用于将该用户标识到API。API密钥是一个十六进制形式的160位数字。这是一个非常庞大的唯一键，这意味着猜测一个API键几乎是不可能的。

在HTTP级别，API密钥通过HTTP基本身份验证发送。使用秘密密钥作为用户名和密码的任何随机字符串。

要使用CURL来制作API请求尝试：

curl -i -u“{api键}：x”“https://api.bamboohr.com/api/gateway.php/（subdomain }/v1/mployees/directory”

大多数浏览器和工具都可以接受URL，例如:

https:// {API密匙}:[电子邮件受保护]/api/gateway.php/ {subdomain }/v1/employees/directory.

有关HTTP基本身份验证的更多信息，请参阅这个有用的维基百科文章。

如果重复使用未知的API键，则API将禁用一段时间的访问。用户仍然能够在此期间登录Bamboohr网站。禁用API时，它将返回HTTP 403对其接收的任何请求禁止响应。