Our API is organized around REST. All of our URLs are predictable and resource-oriented using HTTP response codes to indicate API errors.
All requests must be made over the HTTPS protocol (requests initiated over HTTP are automatically upgraded to HTTPS). We use as many built-in HTTP features as possible such as Cookies, HTTP authentication and HTTP verbs so we can be understood by off-the-shelf HTTP clients.
We also support cross-origin resource sharing, allowing you to interact securely with us from a client-side web application.
JSON encoded in UTF-8 is returned by all API responses, including errors, although our libraries convert responses to appropriate language-specific objects. We're currently supporting 3 platforms:
- Web/Node.js
- iOS (TODO link)
- Android (TODO link)