BRIDGING MULTIPLE API DESCRIPTION FORMATS
WITH RESTLET FRAMEWORK
Leading Web API
Framework for Java
http://restlet.com
May...
CODE YOUR WEB API
IN JAVA LANGUAGE
JAX-RS API
Restlet API
Spring REST
Swagger
annotations
Bean Validation
annotations
Goog...
DOCUMENT YOUR WEB API
IN JAVA LANGUAGE
RESTful
Web API
Web API
definition
1. Code your
web API
(iterate)
3. Introspect
sou...
DON’T GET LOCKED-IN
API DEFINITION PORTABILITY & COPYRIGHT
– No clear winner at this stage
 translate your API definition...
LAUNCH INTROSPECTOR TOOL
SUPPORTS RESTLET API, NEW JAVA APIS COMING
1) Launch from
your IDE or the
command line
2) Web API...
DISPLAY YOUR WEB API DOC
RELAUNCH INTROSPECTOR TO KEEP IN SYNC
CHECK OUT API COMMONS TAB
WEB API MANIFEST BASED ON SWAGGER
CHECK OUT THE HOSTED SWAGGER UI
EMBEDDED IN YOUR WEB SITE
RESTLET PLATFORM
WHAT WE ARE WORKING ON !
 Restlet Framework (open source)
– introspect all main Java APIs
– import & exp...
WEB API FRAMEWORK
FOR JAVA DEVELOPERS
6 editions
44 extensions
1,5 M downloads
100 000 developers
Version 2.2.0 launched
i...
KEEP IN TOUCH!
http://restlet.com
Twitter: @jlouvel
jlouvel@restlet.com
Restlet Platform
PaaS and Web API integration
Inte...
Bridging multiple API description languages with Restlet
Upcoming SlideShare
Loading in …5
×

Bridging multiple API description languages with Restlet

815
-1

Published on

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

Published in: Software, Technology, Education
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
815
On Slideshare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
3
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Bridging multiple API description languages with Restlet

  1. 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. 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. 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. 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. 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. 6. DISPLAY YOUR WEB API DOC RELAUNCH INTROSPECTOR TO KEEP IN SYNC
  7. 7. CHECK OUT API COMMONS TAB WEB API MANIFEST BASED ON SWAGGER
  8. 8. CHECK OUT THE HOSTED SWAGGER UI EMBEDDED IN YOUR WEB SITE
  9. 9. 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
  10. 10. 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
  11. 11. KEEP IN TOUCH! http://restlet.com Twitter: @jlouvel jlouvel@restlet.com Restlet Platform PaaS and Web API integration Interview with Daniel Jacobson (Netflix)
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×