Presentation for API Strategy & Practice workshop at Gluecon 2014 in Boulder, Colorado. 1) Code your web API in Java language 2) Document your web API in Java language 3) Don't get locked in 4) Demo of Restlet Framework + APISpark 5) Restlet Platform, what we are working on! 6) Restlet Framework, web API framework for Java 7) Keep in touch

1. BRIDGING MULTIPLE API DESCRIPTION FORMATS
WITH RESTLET FRAMEWORK
Leading Web API
Framework for Java
http://restlet.com
May 20, 2014
Jérôme LOUVEL
jlouvel@restlet.com

2. CODE YOUR WEB API
IN JAVA LANGUAGE
JAX-RS API
Restlet API
Spring REST
Swagger
annotations
Bean Validation
annotations
Google Cloud
Endpoints API
1. Select
a main
Java API
Java
source
code
3. Write your
Java code
JAXB
annotations
2. Add extra
annotation
APIs
Jackson
annotations
RESTful
Web API
4. Get your
web API

3. DOCUMENT YOUR WEB API
IN JAVA LANGUAGE
RESTful
Web API
Web API
definition
1. Code your
web API
(iterate)
3. Introspect
source code
2. Select
target API
specs
4. Complete
API definition
manually
Swagger
API
Blueprint
RAML
Google API
Discovery
WADL
Intro-
spector

4. DON’T GET LOCKED-IN
API DEFINITION PORTABILITY & COPYRIGHT
– No clear winner at this stage
 translate your API definition between various languages
 use the best of each language ecosystem (tooling,
directory)
– Take API copyright seriously (now)
 play nice in the API economy: open your API definition
– select a Creative Commons or Open Source license
– publish to the « API Commons »
 verify the legal terms of the APIs you depend on

5. LAUNCH INTROSPECTOR TOOL
SUPPORTS RESTLET API, NEW JAVA APIS COMING
1) Launch from
your IDE or the
command line
2) Web API
definition pushed
to APISpark

6. DISPLAY YOUR WEB API DOC
RELAUNCH INTROSPECTOR TO KEEP IN SYNC

7. CHECK OUT API COMMONS TAB
WEB API MANIFEST BASED ON SWAGGER

9. CHECK OUT THE HOSTED SWAGGER UI
EMBEDDED IN YOUR WEB SITE

10. RESTLET PLATFORM
WHAT WE ARE WORKING ON !
 Restlet Framework (open source)
– introspect all main Java APIs
– import & export main API languages
– generate Client SDKs, Server skeletons & HTML
 APISpark (full stack PaaS)
– complete integration of Swagger tool chain
– embed additional tool chains
– GitHub synchronization

11. WEB API FRAMEWORK
FOR JAVA DEVELOPERS
6 editions
44 extensions
1,5 M downloads
100 000 developers
Version 2.2.0 launched
in March 2014
Covers our ROA/D
API guidelines
Consistent client & server API
Powerful routing & filtering
Comprehensive web security
Aligned with REST & HTTP
Fast & scalable

12. KEEP IN TOUCH!
http://restlet.com
Twitter: @jlouvel
jlouvel@restlet.com
Restlet Platform
PaaS and Web API integration
Interview with Daniel Jacobson (Netflix)