Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Easy REST with OpenAPI

236 views

Published on

Easy REST with OpenAPI
Talk by Norbert Hartl, PharoDays2019

Published in: Technology
  • Be the first to comment

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

×