API
Language Bindings
Our RESTful interface requires very little in the way of application bindings. The HTTP response codes from the requests are meant to be interpreted by your application for semantic meaning. BambooHR has created a handful of small wrappers that demonstrate how to make the HTTPS requests to our API. They include the code for doing HTTPS basic auth by specifying your secret key.
All BambooHR bindings on this page are open sourced under a liberal license that should make it possible to use them in nearly all situations. Refer to the comment at the top of the source code for details. If you make changes that you think would be useful to somebody else, then please submit them to us for possible inclusion into our official bindings.
All of the bindings are designed to for a lowest common denominator that minimizes third party requirements. Your platform may have more specialized tools that would work equally well for making RESTful requests.
The BambooHR bindings are built to support pluggable HTTPS classes. This is useful, for example, if you are using PHP but don't have access to curl. In such a case, you could build your own compatible HTTPS class that uses command line tools and the higher level of the binding would be able to communicate through your new plugin. You are welcome to create your own HTTPS class and use it with these bindings. A default HTTPS plugin is provided with each binding.
Alpha quality
The BambooHR API Bindings are all of alpha release quality. We are making these bindings available to our customers and partners to preview the API and bindings. The structures and methods used in these bindings are subject to change at any time before the 1.0 release.
The following sample bindings are available (click to download):
- PHP (version 0.9) - Requires curl support in PHP
- .NET (version 0.9)
- Java (version 0.9) - Requires sun.misc.BASE64Encoder
Have more questions? We're here to help, so please contact us.