
eXo Platform 3.0 comes with a set of APIs to help you build your own applications from eXo services.

h2. Definitions of API Levels {anchor:id=DEV.eXoPlatformSupportedAPIs.DefinitionsOfAPILevels}

APIs vary according to level of maturity. It is important to understand the eXo's general approach to API change management.

The different levels of APIs are described in the following table:
|| API Level || Test Suite || Clients || Documentation || Support || Compatibility X.Y.Z(+1) || Compatibility X.Y(+1)
|*Platform API*| !yes.gif! | !yes.gif! | !yes.gif! | !yes.gif! | !yes.gif! | !yes.gif! |
|*Provisional API*| !yes.gif! | !yes.gif! | !yes.gif! | !yes.gif! | !yes.gif! | !no.gif! |
|*Experimental API*| !yes.gif! | !no.gif! | !yes.gif! | Best effort | Best effort | !no.gif! |
|*Unsupported API*| !no.gif! | !no.gif! | !no.gif! | !no.gif! | !no.gif! | !no.gif! |

*Test Suite*: A suite of tests that can be run against the API to detect changes.

*Clients*: The API has been used successfully by at least 2 different teams, using API Documentation only.

*Documentation*: The API has a clean JavaDoc and reference documentation.

*Support*: The eXo Support team provides help on the code that uses this API, and fixes any reported bugs.

*Compatibility X.Y.Z(+1)*: The compatibility between maintenance versions (X.Y.Z and X.Y.Z+1) is guaranteed. If a change appears between X.Y and X.Y+1, the eXo Support team will help by upgrading the code.

*Compatibility X.Y(+1)*: The compatibility between minor versions (X.Y and X.Y+1) is guaranteed. If a change appears between X and X+1, the eXo Support team will help by upgrading the code.

*Best Effort*: We will provide assistance, but eXo cannot guarantee any specific result.


h3. Use Provisional or Experimental APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.UseProvisionalOrExperimentalAPIs}
These APIs are provided to give an "early look" at what will be available in upcoming versions of the eXo Platform. These APIs are not final, but they can be used to start developing your application.

*Provisional APIs* are APIs close to being frozen, but that need a last look from users. They can be used by third-party developers for their own apps, with the knowledge that only a limited compatibility guarantee is offered.

*Experimental APIs* are APIs that are likely to change. They are published in order to get feedback from the community. These APIs have been tested successfully, but have not yet had enough feedback from developers.

h2. Platform APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.PlatformAPIs}

h3. Java APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.JavaAPIs}

*[Portlet API|/docs/refguide/html/bk02ch04.html#sect-Reference_Guide-Portlet_Primer] (JSR 168 and JSR 286)*: A Java standard that defines how to write portlets. This is the way to develop Java applications that are integrated into eXo Platform.

*[WSRP 1.0|/docs/refguide/html/bk02ch07.html#wsrp-Introduction] on JBoss*: A network protocol for integrating remote portlets into eXo Platform.

*[JAX-RS|/docs/refguide/html/ch-introduction-to-rest.html#d0e17006] (JSR 311)*: A standard API that provides support for creating REST-like services.

*[JCR|/docs/refguide/html/ch-intro.html#d0e32] (JSR 170)*: A standard API that provides access to a content repository.

*[JCR Service Extensions|/docs/refguide/html/ch-jcr-extensions.html#d0e512]*: A set of APIs that provide extended functionalities for the JCR, such as observation, permissions, and access to a repository.

*[Java EE 6|http://www.oracle.com/technetwork/java/javaee/overview/index.html]*: eXo Platform supports the Java EE 5 APIs, so you can develop applications using this standard.

*[Cache|/docs/refguide/html/ch-cache.html#d0e13710]*: An API used for data caching.

*[Event and Listener|/docs/refguide/html/ch-understanding-listeners-service.html#d0e13389]*: An API for listening and sending events within eXo Platform.

*[Organization|/docs/refguide/html/ch-organization-service.html#Overview]*: An API and SPI for accessing user, group and membership information.

*[Portal Container Definition|/docs/refguide/html/ch-service-configuration-for-beginners.html#d0e11071]*: This API is used to configure your portal.

*[Taxonomy|/docs/refguide/html/bk03ch07.html#CONTref.JavaServices.TaxonomyService]*: An API that allows you to organize your content.

*[Link Management|/docs/refguide/html/bk03ch07.html#CONTref.JavaServices.LinkManager]*: An API that provides a way to manage links when developing WCM features.

*[Publication Management|/docs/refguide/html/bk03ch07.html#CONTref.JavaServices.PublicationManager]*: An API that provides different ways to manage the publication of content when developing WCM features.

*[WCM Composer|/docs/refguide/html/bk03ch07.html#CONTref.JavaServices.WCMComposer]*: An API to get content shown in the website. The cache management is used in this service, and methods to update the content cache.

*[Template WCM|/docs/refguide/html/bk03ch03.html#CONTref.Configuration.Templates]*: An API to provide views and dialogs to node types (system or document).

*[XML Configuration|/docs/refguide/html/ch-services-wiring.html#d0e13290]*: A set of DTD for configuring eXo Platform.

h3. JavaScript APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.JavaScriptAPIs}

*[OpenSocial 0.8 Gadget Specification|http://www.opensocial.org/Technical-Resources/opensocial-spec-v08/opensocial-reference08]*: A standard that defines how to write gadgets and provide APIs. Gadgets are particularly useful for integrating external applications into eXo Platform.

h3. Web Services {anchor:id=DEV.eXoPlatformSupportedAPIs.WebServices}

*[CMIS|/docs/refguide/html/bk05.html#CMIS.Administrator.Guide]*: A standard API that gives access to the content repository via REST and SOAP Web services.

*[FTP|/docs/refguide/html/ch-ftp.html#d0e7058]*: A standard protocol for exchanging documents.

*[OpenSocial 0.8 REST Protocol|http://www.opensocial.org/Technical-Resources/opensocial-spec-v081/restful-protocol.html]*: A standard API for accessing the social graph and activity streams.

*[WebDAV|/docs/refguide/html/ch-webdav.html#d0e6836]*: A standard protocol for exchanging document over HTTP.

h2. Provisional APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.ProvisionalAPIs}

h3. Java APIs {anchor:id=DEV.eXoPlatformSupportedAPIs.ProvisionalAPIs.JavaAPIs}

*UI Extensions*: An API to plug new actions into the eXo Platform UI.

*[DocumentExplorer Toolbar|http://wiki.exoplatform.com/xwiki/bin/view/ECM/UI%20Extension%20Framework#HCreateyourUIAction]*

*[ECM Admin|/docs/refguide/html/bk03ch06.html#CONTref.Extensions.UIExtensions.AddOwnTabInECMAdministration]*

*[Activity Sharing|/docs/refguide/html/bk08ch03.html#Developer_document.Create the activity plug-in]*

