Huddle for Developers
Welcome to our developer zone. Here you will find information to help you build applications and mash-ups using Huddle’s developer API. You can read news and updates about our API on our blog
API FAQ
What’s an API?
Read Wikipedia’s official description here. The Huddle API lets you access our tools to incorporate Huddle’s functionality into your own applications.
What formats does your API support?
The Huddle API is a simple HTTP service secured via SSL. All requests and responses are encoded using the JSON format. We will be adding more formats (REST-JSON, REST-XML and SOAP) in the near future.
How does authentication work?
All API requests require authentication. We use standard HTTP Basic Authentication where username and password are sent as base 64 encoded clear text. All API calls are protected by SSL so that your details remain secure.
HTTP Header Example:
GET /v1/json/files/12345 HTTP/1.1
Host: api.huddle.dev
Authorization: Basic dXNlcjpwYXNz
What functionality does your API currently support?
The API currently provides methods to work with files, tasks and discussions, as well as workspaces and newsfeeds. You can see the whole list of methods here. We’re constantly adding new methods so check back often.
Are there any examples?
There are several working applications that use the Huddle API (with more coming very soon, we’re told!)
- Clustr – access Huddle information from any mobile device
- Desktop – Adobe AIR application to access Huddle from your desktop (works on Windows, Mac and Linux)
- AlertThingy – streams Huddle updates alongside updates from Twitter, Facebook and more
If you have an application or mashup you’d like added to our forthcoming showcase then send an email to developers@huddle.net with the details.
You can also take a look at the magical Huddle File Ferret – a sample Javascript and jQuery application, illustrating a simple use of the Huddle.net API. Documentation for the app is available here
Are there any legal things to be aware of?
Use of the Huddle API is governed by section 6 of our Terms and Conditions. Note that any tools that consume our API should use the following badge:
Need anything else? Please email us on developers@huddle.net and we’ll try and give you all the information you need.
