RESTful URLs: http://microformats.org/wiki/rest/urls
Describe all (registered entities): 76
General notes on special params and headers:
no-cache - this will cause the caching headers to be set for no caching (default caching is set based on last modified date on entity OR 5 minutes)
last-modified - this will force the last-modified date header to be set (unix timestamp in ms), no-cache overrides this
accept - this standard header can be used in place of format extensions (e.g. xml), just leave the extension off the URL
When searching for entities in a list, the following params are handled specially in the system (note that all the RoR conventions are followed for sorting/paging):
_start (number): the position of the first entity to return (0 is the first), e.g. _start=5
_page (number): the page of data to display (0 is first), e.g. _page=2
_perpage (number): the number of entities to return for the page (0 means all), e.g. _perpage=20
_limit (number): the maximum number of entities to return (0 means all), e.g. _limit=50
_order (string): the sort order to return entities in (default is ascending), should be a comma separated list of entity field names which optionally include a suffix to determine order, suffix can be _reverse or _desc for descending order OR '' (blank) or _asc for ascending order, e.g. _order=name OR _order=name_reverse OR _order=name,email_desc,firstname_asc,lastname_reverse
_sort (string): same as order
_validateSession: supply this parameter if sessions are to be explicitly checked to ensure a valid session. Without this, the session validation is left to the provider
Represents announcements for a given site (including merged announcements) or all announcements for a user. Also includes Message Of The Day and public announcements. There are three optional URL parameters available: 'n' to set the total number of announcements returned, 'd' to set the number of days in the past to retrieve announcements for, and 'a' to set an ascending sort order of true or false. If the system is configured with the (default) 'Announcement Reorder' property, announcements will be additionally sorted by the message_order. If these parameters are not set, they are retrieved from the tool configuration, or the standard defaults of n=3, d=10, a=0 are used. For example /announcements/site/mercury.json?n=20&d=100&a=1 will retrieve up to 20 total announcements for up to 100 days ago with an ascending order.
Represents assignments for a given site.
Represents calendar events.
A chat channel represents a chat room in a context (site).
A chat message represents a message in a chat channel (room).
Provides a set of RESTful endpoints for retrieving COMMONS posts.
Represents the Content/Resources tool
Represents the Drop Box tool
Provides a set of RESTful endpoints for retrieving single fora, site collections of fora , individual topics (collections of conversations) and messages with their children. An example workflow would be to call the site action with /direct/forums/site/SITEID.json for the top level fora in a site, then to use /direct/forums/site/SITEID/forum/FORUMID.json to get an individual forum to the topic level. After that you would use /direct/forums/site/SITEID/forum/FORUMID/topic/TOPICID.json to get a topic, basicallya set of conversations, then you would call /direct/forums/site/SITEID/forum/FORUMID/topic/TOPICID/message/MESSAGEID.json to get a fully populated message with attachments and children.
Allows access to the various data structures available from the LTIService support LTI 1.x and LTI 2.x work. Collection endpoints allow the use of first= last= and order= parameters.
Represents mailarchive messages for a given site
Represents a user's membership in a location (site, group, etc.) in the system, works with the site/group entities and the user entities. In the documentation below, a membership ID is a string in the form USER_ID::LOCATION_REFERENCE (e.g., "aaronz::site:mySiteId").
A set of URLs that can be used for directly linking to various pages and views in Profile2.
Allows access to Sakai's email notification handling
Represents the Podcast tool
Deprecated. Use polls entity provider. Represents a poll (single item survey) and optionally the votes (responses) to the poll and options (choices)
Deprecated. Use polls entity provider. Represents an option (choice) in a poll
Deprecated. Use polls entity provider. Represents a user's vote in a poll
Represents polls, options (choices), and votes of the poll tool.
Presents an HTTP interface onto Sakai's portal chat system.
Enables anonymous reporting of tool usage to SiteStats. There are no usable interfaces here.
Allows access to the Profile2 messaging system
Represents a user's status.
Represents settings in the server configuration
Represents a user or system session which is currently active, inactive sessions or information about inactive sessions cannot be accessed, the session is effectively immutable and removing it is the same as deactivating it, updating simply has the effect of refreshing it so it will not timeout
Represents a site (a collection of users and tools) in the Sakai system
Provides a set of RESTful endpoints for retrieving Sitestats event data.
Provides SiteStats event aggregator metrics for the current server node
Represents the Syllabus tool
An entity provider to allow shortening of URLs via the ShortenedUrlService
Represents a user in the system, user data is effectively immutable and removing users cannot override externally provided users
User Preference Values
Represents the Web Content tool
Provides a set of RESTful endpoints for retrieving wiki pages.
REST:: 1.0.1 SVN: $Revision$ : $Date$