| CALLISTAENTERPRISE.SE

RAML

OLA DEIBITSCH

2015-01-28

PROBLEM – RECAP…

2

SOAP/WSDL Complex

Structured

REST/RAML Simple Structured

"RESTful API Modeling Language (RAML) is a simple and succinct way of describing practically-RESTful APIs. It encourages reuse, enables discovery and pattern-sharing, and aims for merit-based emergence of best practices. The goal is to help our current API ecosystem by solving immediate problems and then encourage ever-better API patterns. RAML is built on broadly-used standards such as YAML and JSON and is a non-proprietary, vendor-neutral open spec.", www.raml.org

RAML BY THE RAML WORKGROUP – RECAP…

3

RAML TOOLING – REVISTITED…

4

SoapUI RAML Plugin

RAML to HTML JAXRS-to-RAML

RAML2Wiki RAMLang

Osprey APIkit

ATOM RAML Package

RAML Sublime Plugin

RAML for JAXRS

Restlet Studio …

swagger2raml API Designer

•  Resources: -  /patients -  /patients/{patientId} -  /patients/{patientId}/notes -  /patients/{patientId}/appointments -  …

•  Verb -  Get/Post/Put/Delete…

•  Metadata -  Authorization Header -  Filtering

•  Representations: -  JSON, XML, ?.

REQUIREMENTS: CALLISTA CARE API – RECAP…

CALLISTA CARE API - RECAP

6

RAML TOOLING – SOAPUI RAML PLUGIN - DEMO

7

8

RAML TOOLING – RAML2HTML- DEMO

RAML 1.0 spec is out and waiting for feedback!

RAML 1.0

9

See https://github.com/raml-org/raml-spec/milestones/v1.0

§  API Explosion

§  It is clear that we need a modeling language!!

§ RAML is a clean, simple and contract-first development approach.

§  Tool support begins to mature…

§  Slowly, we begin to see momentum… …and RAML 1.0 is upcoming…

SUMMARY

10