*Objectives*:

 The third parties want to integrate and extend the eXo Social capability and features and eXo Social REST Services APIs are dedicated for them to complete that. By using these REST APIs, the third 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.

The JSON support is mandatory. The other format SHOULD be supported too (XML, RSS, ATOM). The supported formats will be specified by the detailed documentation for the 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}_: _{noformat}socialdemo{noformat}_;

* 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"}
