Aalto Social Interface, or ASI, is a RESTful platform for social media applications. Using ASI, anyone can create their own application that is available to the OtaSizzle user base and social network. An ASI application will not necessarily even need its own database.
Getting Started
Read the tutorial Create new services using ASI in SizzleLab's ASI wiki.
Or try the interactive tester if you already have an application account.
Instructions in a nutshell are:
- POST /session to create a new session.
- GET resources to view them, create new ones with POST and update them in place with PUT. DELETE is also supported.
- If you're unable to PUT or DELETE, use POST with the actual method in the magic field _method.
- DELETE /session when finished.
All the calls to ASI resources can (and should) be made with an additional event_id parameter. This parameter is intended for the research log to be a semantic identifier of what the user was actually doing when this request was made. So it could be something like "Kassi::ShowItemsListing::2009-07-30_14:17:23::02313" but the message format is not restricted to anything. This identifier should persist for all the ASI-requests for the same action, for example when the user loads a single page in a client application, but a new one must be made for the next action. The parameter's format should be somewhat consistent between calls.
The ASI resources description
The following image contains a short overview of the ASI resources. The image is meant for obtaining an overall understanding of the system. A more throughout description can be found from the API reference.
