REST API

From the Directed Edge Developer Base
Revision as of 03:04, 23 May 2009 by Scott (talk | contribs) (API Authentication)
Jump to: navigation, search

The Directed Edge REST API is a fairly simple way of modeling a collection of items and the relationships between them. These relationships are used as the basis for finding similar items or delivering personalized recommendations to a user. Information is encoded using our XML Format using notions from the API Concepts.

REST APIs allow for using the HTTP methods GET, PUT, POST and DELETE on various resources. Resources are just normal URLs organized hierarchically. In our case there is the database, items and things you can do with items (query, update, etc.).

Let's have a look at an example URL:

https://username:password@webservices.directededge.com/api/v1/wikipedia/

This is the URL for the wikipedia database. Many of the elements are constant — notably the host name, and the "api/v1" sections. We'll break down the other resources and the methods allowed on them in the following sections.

HTTP and HTTPS

The Directed Edge API allows for both HTTP and secured HTTPS connections. HTTPS tends to incur a slightly higher latency since setting up the connection is more involved.

API Authentication

We use HTTP Basic authentication exclusively at the moment. HTTP Basic just means a user name and password that you stick at the front of the URL, just like if you were connecting to an FTP site. For example:

https://user:password@...

When your account was created for use with the Directed Edge recommendation engine you should have been send a user name and a (usually freakishly long) password. We can reset your password for you at any time, but can not provide your current password if you lose it.

Database resource

HTTP GET

HTTP PUT

Item resource

HTTP GET

HTTP PUT

HTTP DELETE

Add and remove sub-resources

HTTP PUT

Related / recommended resources

HTTP GET

Query Parameters