Post on 31-Aug-2014
description
The advantage of Using Rest API’s
in Portal Platforms to extend the
reach of the portal.
www.entando.com
info@entando.com
About Entando
Portal, web CMS and web framework all in one platform
3
Social Citizen Engagement
Social Media
Portal, Mobile App, Social
Networks
Analytics
Why Rest Api’s
■ Rich web clients can talk directly with your Application
■ Useful when you have to integrate multiple different clients
■ RESTful way takes less effort
■ Works Out of the Box no setup, just a design model
■ Standardize Development
■ Standard API - Creating an API on standards that already exist
makes it much easier for application developers to use your API
■ …
4
Entando Guideline
■ Entando REST Api’s need to provides access to data & services via a
standard JSON/XML-based Api
■ All Entando REST Api’s resources need to be accessed using a base
URI <APPLICATION_BASE_URL>/api/rs/<LANG_CODE>/<NAMESPACE>/<RESOURCE_NAME>.<EXTENSION>?<QUERY_STRING>
myportal.com/api/rs/en/jcms/contents?contentType=CNG
myportal.com/api/rs/en/jcms/content.json?id=CNG51
■ All response need to be Self Documented
■ …
5
Building a CardManager (Api Definition)
Building a CardManager (Bean Definition)
8
Building a CardManager
public class CardManager {
public List<Card> getCardsForApi(Properties properties) throws Throwable {
String holder = properties.getProperty("holder");
return this.searchCards(holder);
}
public Card getCardForApi(Properties properties) throws Throwable {
String idString = properties.getProperty("id");
int id = 0;
try {
id = Integer.parseInt(idString);
} catch (NumberFormatException e) { throw new
ApiException(IApiErrorCodes.API_PARAMETER_VALIDATION_ERROR, "Invalid number format
for 'id' parameter - '" + idString + "'", Response.Status.CONFLICT);
}…
Entando & Rest API
Entando & Rest API
Small, Medium and Large Govs
11
www.entando.co
m
Thank you
12
info@entando.com
@EntandoSrl
Entando
@ Entando
Follow us
www.entando.co
m www.entando.com
m
https://github.com/entando
Q&A