Successfully reported this slideshow.
Your SlideShare is downloading. ×

Easy REST with OpenAPI

Upcoming SlideShare
Yesplan: 10 Years later
Yesplan: 10 Years later
Loading in …3
×

Check these out next

1 of 16 Ad
1 of 16 Ad
Advertisement

More Related Content

Advertisement

Easy REST with OpenAPI

  1. 1. Easy REST with OpenAPI Norbert Hartl ZWEIDENKER GmbH
  2. 2. ZWEIDENKER GmbH • 10 years old • Software solutions for mobile, web and backend-only, too • Pharo usage is growing steadily • In cologne and organizing this year’s ESUG
  3. 3. REST
  4. 4. REST REpresentational State Transfer
  5. 5. REST • It uses HTTP
  6. 6. REST • It uses HTTP • It is resource based
  7. 7. REST • It uses HTTP • It is resource based • It is not RPC
  8. 8. REST • It uses HTTP • It is resource based • It is not RPC • It’s about hyper media
  9. 9. REST usually means • Extract and validate parameters from request • Checking constraints of payload • Produce documented response
  10. 10. JSON Schema { #name -> (JSONSchema string). #age -> (JSONSchema integer) } asJSONSchema
  11. 11. OpenAPI Spec … "/pets/{petId}" : { "get" : { "summary" : "A call to acquire a pet", "operationId" : "fetchPet", "parameters" : [ { "name" : "petId", "in" : "path", "schema" : { "type" : "integer" } } ], "responses" : { "200" : { "content" : { "application/json" : { "schema" : …
  12. 12. DEMO
  13. 13. OpenAPI • Specify Calls and data constraints • Serialize to JSON spec • Can be consumed by a client to automatically create spec conform requests
  14. 14. Questions?
  15. 15. OpenAPI Try https://github.com/zweidenker/OpenAPI Complain to Norbert Hartl norbert@2denker.de

×