*Objectives*:

 The 3rd parties want to integrate and extend eXo Social capability and features and eXo Social REST Services APIs are dedicated for them to complete that. By using these REST APIs, the 3rd parties can write any applications (desktop apps, mobile apps, web apps) to integrate with eXo Social services and business.

*Conventions*:

The entry point for Social Rest service must be: {noformat}/{rest_context_name}/private/api/social/{version}/{portalContainerName}/{social_resources}/{noformat}. An example of activities resources: /rest/private/api/social/v1-alpha1/portal/activity/.

There are 3 types of parameters on each URL:

* *{noformat}{server_params}{noformat}*: this is the unchanged parameter for a specified server.

* *:id*: this param is for a specified data object, for example, activity Id and identity Id.

* *format*: this is the supported data format. It can be json, xml, rss, or atom.

*Notes*:

Currently, only the basic authentication is supported. Please see more details at http://en.wikipedia.org/wiki/Basic_access_authentication.

JSON support is mandatory. Others format SHOULD be supported, too (XML, RSS, ATOM). The supported formats will be specified by the detailed documentation for REST resources.

The *{noformat}rest_context_name{noformat}* and *{noformat}portal_container_name{noformat}* parameters are used as follows:

* On eXo Social standalone: *{noformat}rest_context_name{noformat}*: {noformat}rest-socialdemo{noformat}; *{noformat}portal_container_name{noformat}*: socialdemo.

* On eXo Platform: *{noformat}rest_context_name{noformat}*: rest; *{noformat}portal_container_name{noformat}*: portal.

h1. Activity Resources  {anchor:id=SOCref.DevelopersReferences.RestService_APIs_v1alpha1.ActivityResources}
{include:document="RestService_v1_alpha1/Activity_Resources_v1_alpha1.wiki"}

h1. Activity Stream Resources  {anchor:id=SOCref.DevelopersReferences.RestService_APIs_v1alpha1.ActivityStreamResources}
{include:document="RestService_v1_alpha1/Activity_Stream_Resources_v1_alpha1.wiki"}

h1. Identity Resources {anchor:id=SOCref.DevelopersReferences.RestService_APIs_v1alpha1.IdentityResources}
{include:document="RestService_v1_alpha1/Identity_Resources_v1_alpha1.wiki"}

h1. Version Resources   {anchor:id=SOCref.DevelopersReferences.RestService_APIs_v1alpha1.VersionResources}
{include:document="RestService_v1_alpha1/Version_Resources_v1_alpha1.wiki"}
