Server API

OAuth

Most API calls require an OAuth access token. Once obtained add the token to the Authorization header as "Bearer token"

TODO How to get & use oauth token

API Calls

GET https://aestheticodes.appspot.com/recommended?lat=52.951913&lon=-1.186150

Lists of recommended Artcodes, grouped into popular, nearby and featured. Lat and lon parameters are optional and are used to work out the nearby Artcodes. Authentication not required.

{
  "popular": [
    "http://aestheticodes.appspot.com/experience/04f7043d-0cf2-4d30-befc-57583a072d3d", 
    "http://aestheticodes.appspot.com/experience/805222d4-ed96-4365-9eee-b3e7abbda494", 
    "http://aestheticodes.appspot.com/experience/4c758e29-0759-4583-a0d4-71ee692b7f86", 
    "http://aestheticodes.appspot.com/experience/04f2f932-d185-40b4-8921-53f5ff7c7072", 
    "http://aestheticodes.appspot.com/experience/27f3fe95-59db-44c3-ae01-c7b52cca8fc5", 
    "http://aestheticodes.appspot.com/experience/b4be9d69-be77-4e16-85f1-24f5022a2317"
  ], 
  "featured": [], 
  "nearby": [
    "http://aestheticodes.appspot.com/experience/214b4d90-7a01-462e-806b-b7e8b9961f27", 
    "http://aestheticodes.appspot.com/experience/945e1938-d804-4c20-9b8a-1d9d0a1d6d8d", 
    "http://aestheticodes.appspot.com/experience/7e43b1ea-fd17-47f2-966f-4f44780b233a", 
    "http://aestheticodes.appspot.com/experience/526e7dd8-55a5-47b2-a7ce-04676a72695b", 
    "http://aestheticodes.appspot.com/experience/3e1daac2-6b1d-40b9-a6be-6d874b166eab", 
    "http://aestheticodes.appspot.com/experience/d7c4a66e-d73a-4282-be6d-1c058acaf2fd"
  ]
}

GET https://aestheticodes.appspot.com/search?q=test

Returns a json object containing a list of experience ids of experiences that match the search terms. Authentication not required.

• q - the search terms

[
"http://aestheticodes.appspot.com/experience/c161004c-1161-4a79-a9bb-b537bf1909d4",
"http://aestheticodes.appspot.com/experience/93350b2c-29bb-49c9-9c13-af363f91a349"
]

GET https://aestheticodes.appspot.com/experiences

Returns a json object containing a list of experience ids of experiences owned by the requesting user.

[
"http://aestheticodes.appspot.com/experience/c161004c-1161-4a79-a9bb-b537bf1909d4",
"http://aestheticodes.appspot.com/experience/93350b2c-29bb-49c9-9c13-af363f91a349"
]

GET https://aestheticodes.appspot.com/experience/_experience_id_?format=json

Returns the json of the experience. Without format=json, will return a html page with links to install the apps.

DELETE https://aestheticodes.appspot.com/experience/_experience_id_

Delete an experience. Needs to be owner of the experience.

PUT https://aestheticodes.appspot.com/experience/_experience_id_

Edit an experience. Needs to be owner of the experience.

POST https://aestheticodes.appspot.com/experience

Create a new experience. Returns the json of the new experience.