Easy REST with OpenAPI

Easy REST with OpenAPI

• 1.
  Easy REST with OpenAPI NorbertHartl ZWEIDENKER GmbH
• 2.
  ZWEIDENKER GmbH • 10years old • Software solutions for mobile, web and backend-only, too • Pharo usage is growing steadily • In cologne and organizing this year’s ESUG
• 3.
  REST
• 5.
  REST REpresentational State Transfer
• 6.
  REST • It usesHTTP
• 7.
  REST • It usesHTTP • It is resource based
• 8.
  REST • It usesHTTP • It is resource based • It is not RPC
• 9.
  REST • It usesHTTP • It is resource based • It is not RPC • It’s about hyper media
• 10.
  REST usually means •Extract and validate parameters from request • Checking constraints of payload • Produce documented response
• 11.
  JSON Schema { #name ->(JSONSchema string). #age -> (JSONSchema integer) } asJSONSchema
• 12.
  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" : …
• 13.
  DEMO
• 14.
  OpenAPI • Specify Callsand data constraints • Serialize to JSON spec • Can be consumed by a client to automatically create spec conform requests
• 15.
  Questions?
• 16.
  OpenAPI Try https://github.com/zweidenker/OpenAPI Complain to Norbert Hartl [email protected]