© Restlet 2016
workshop
Restlet experience
Boston, 11/2/2016
© 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
© 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 centric
software
Mobile app
backend
IoT
backend
Micro
service
Web app
backend
Social bot
backend
Partner
API
gateway
Public
API
gateway
Automated
workflow
© Restlet 2016
Continuous API Delivery
DEV
API centric
software
QA
OPS
BIZ
Create
TestEngage
Run
© Restlet 2016
1 | Code-first & Provider driven
Provider
team
Consumer
teams
API
Impl
SDK
Client
A
SDK
Client
B
...
...
3
1
2
© Restlet 2016
2 | Contract-first & Provider driven
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
© Restlet 2016
3 | Collaborative Contract-first
Provider
team
Consumer
teams
Impl
SDK
Client
A
SDK
Client
B
...
...
2
1
Mock
2
API
© 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
© 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
© Restlet 2016
API Team Collaboration
Owner
Developer Writer
Tester
Operator
API
Team
Manager
© 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 Studio - Collaborative & visual API design
© Restlet 2016
DHC - Collaborative & automated API testing
© Restlet 2016
APISpark - Data API creation & operations
© 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
© Restlet 2016
Thanks!

APIStrat Open API Workshop

  • 1.
    © Restlet 2016 workshop Restletexperience Boston, 11/2/2016
  • 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 APIUse 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
  • 5.
    © Restlet 2016 ContinuousAPI Delivery DEV API centric software QA OPS BIZ Create TestEngage Run
  • 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 APITeam 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
  • 13.
    © Restlet 2016 RestletStudio - Collaborative & visual API design
  • 14.
    © Restlet 2016 DHC- Collaborative & automated API testing
  • 15.
    © Restlet 2016 APISpark- Data API creation & operations
  • 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
  • 17.