More Related Content
Similar to APIStrat Open API Workshop (20)
APIStrat Open API Workshop
- 2. © Restlet 2016
x
© Restlet 2016
Jérôme LOUVEL
About 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
- 3. © Restlet 2016
x
© Restlet 2016
• Increasing API Use Cases
• Continuous API Delivery
• API Team Collaboration
Why API Description
Formats?
- 4. © Restlet 2016
API Use Cases
API centric
software
Mobile app
backend
IoT
backend
Micro
service
Web app
backend
Social bot
backend
Partner
API
gateway
Public
API
gateway
Automated
workflow
- 6. © Restlet 2016
1 | Code-first & Provider driven
Provider
team
Consumer
teams
API
Impl
SDK
Client
A
SDK
Client
B
...
...
3
1
2
- 7. © Restlet 2016
2 | Contract-first & Provider driven
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
- 8. © Restlet 2016
3 | Collaborative Contract-first
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
- 9. © Restlet 2016
4 | Contract-first & Consumer Driven
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
Mock
API
Impl
Mock
API
Impl
ServicesData
- 10. © Restlet 2016
5 | Contract-first & Consumer Owned
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
Mock
API
Impl
Mock
API
Impl
Data Services
- 11. © Restlet 2016
API Team Collaboration
Owner
Developer Writer
Tester
Operator
API
Team
Manager
- 12. © Restlet 2016
x
© Restlet 2016
• Restlet Studio → Collaborative & visual API design
• DHC → Collaborative & automated API testing
• APISpark → Data API creation & operations
Restlet Tools
- 16. © 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