Devoxx2012 Entando restapi

The advantage of Using Rest API’s in Portal Platforms to

extend the reach of the portal.

Rinaldo BonazzoPre-Sales Engineer

Entando Srl@RinaldoBonazzo

3

Rinaldo BonazzoSpeaker Bio■ Over 30 years experience in the IT world.

Passionate about new technology and always open to new solution.

■ My Last projects■ Entando ■ Optibirth■ European community Project Manager(Eurovet II, Optibirth,

…)■ aDoc, …

About Entando

Portal, web CMS and web framework all in one platform

4

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■…

5

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=CNGmyportal.com/api/rs/en/jcms/content.json?id=CNG51

■ All response need to be Self Documented■…

6

Building a CardManager (Api Definition)

Building a CardManager (Bean Definition)

9

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

12

www.entando.com

Thank you

13

[email protected]

@EntandoSrl

Entando

@ Entando

Follow us

www.entando.com www.entando.c

ommhttps://github.com/entando

Q&A