竹子开发人员中心

欢迎来到竹子开发人员中心。您可以找到全面的指南和文档,以帮助您尽快使用Bumboohr,以及如果您陷入困境,支持。让我们跳进去!

开始

API入门

我们的Open API可以轻松将其他应用程序集成到Bamboohr中。使用本指南即可在系统中开始在系统中共享数据。

容易访问。容易修改。

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

永远不要错过任何东西!

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

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

开始你需要做什么?

如果您是一个客户或正在为单个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对其接收的任何请求禁止响应。

20天前更新


下一步是什么

查看有关为API标准响应代码进行请求的详细信息。

技术概述

API入门


我们的Open API可以轻松将其他应用程序集成到Bamboohr中。使用本指南即可在系统中开始在系统中共享数据。

建议的编辑是有限的API参考页面

您只能建议对Markdown主体内容进行编辑,而不能建议对API规范进行编辑。