apistrat open api workshop
TRANSCRIPT
© Restlet 2016
x
© Restlet 2016
Jérôme LOUVELAbout Jérôme LOUVEL
• Founder, CTO & VP of Products at Restlet
• Restlet Framework creator,first REST framework for Java (2004)
• Contributor to “RESTful Web Services” (O’Reilly, 2007)
• Member of JAX-RS 1.0 expert group (2007 - 2009)
• Co-author of “Restlet in Action” (Manning, 2012)
• InfoQ editor covering Web APIs (since 2014)
• Board member of OAI
© Restlet 2016
x
© Restlet 2016
• Increasing API Use Cases
• Continuous API Delivery
• API Team Collaboration
Why API Description Formats?
© Restlet 2016
API Use Cases
API centricsoftware
Mobile app backend
IoTbackend
Micro service
Web app backend
Social botbackend
Partner API
gateway
PublicAPI
gateway
Automatedworkflow
© Restlet 2016
1 | Code-first & Provider driven
Providerteam
Consumer teams
API
Impl
SDK
ClientA
SDK
ClientB
...
...3
1
2
© Restlet 2016
2 | Contract-first & Provider driven
Providerteam
Consumerteams
Impl
SDK
ClientA
SDK
ClientB
...
...2
1Mock
2
API
© Restlet 2016
3 | Collaborative Contract-first
Providerteam
Consumer teams
Impl
SDK
ClientA
SDK
ClientB
...
...2
1Mock
2
API
© Restlet 2016
4 | Contract-first & Consumer Driven
Providerteam
Consumerteams
Impl
SDK
ClientA
SDK
ClientB
...
...2
1Mock
2
APIMockAPI
Impl
MockAPI
Impl
ServicesData
© Restlet 2016
5 | Contract-first & Consumer Owned
Providerteam
Consumer teams
Impl
SDK
ClientA
SDK
ClientB
...
...2
1Mock
2
APIMockAPI
Impl
MockAPI
Impl
Data Services
© Restlet 2016
x
© Restlet 2016
• Restlet Studio → Collaborative & visual API design
• DHC → Collaborative & automated API testing
• APISpark → Data API creation & operations
Restlet Tools
© Restlet 2016
Restlet & OAS
• Visually edit OAS definitions→ easier learning curve→ boost productivity
• Import existing OAS definitions→ older versions and alternative formats→ generates API test scenarios
• Export OAS definitions→ share the API description with other tools
• Display OAS as interactive doc→ embed Swagger UI in API portal