The primary goal of the Enthusem API is simplicity. In fact, to use this API all you need to know is how to create an HTTP form POST and how to parse an XML response.

Getting Started

For starters, you'll always be submitting a SSL secured HTTP POST to a URI in the following format:

https://api.enthusem.com/services/xml/?method={method}&apikey={apikey}&token_id={token_id}

The {method} variable is the name of the method you want to call and the {apikey} is a unique value you get when you signup for an enthusem.com developer account. The {apikey} value stays constant unless you request a new apikey for your developer account.

Since every request you make is an HTTP POST you'll need to know what parameters are expected for each method. Every method is going to return an XML response that will either be the results from a successful method call or the XML returned will indicate an error and provide an error code and message (see Error Response Format below).

Most methods will require you to pass a "token" value in the query string. The token value is a simple authentication key that you request before each session by calling the user.getToken method.