容易访问。容易修改。
Bamboohr API是一个恢复的互联网协议,其围绕制作语义有意义的HTTPS请求来访问或修改资源(通常由员工完成)。API可用于操纵员工数据并以多种格式生成报告。
永远不要错过任何东西!
注册我们的邮件列表以在有计划更改或添加到API添加时接收更新。我们可能偶尔会为您的输入伸出援手!
在此注册://www.vietgest.com/api-mailing-list/
你需要什么来开始呢?
- 要编写代码的软件开发人员
- 一个HTTP客户端:
如果您是客户或正在为单个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对其接收的任何请求禁止响应。
7天前更新