h8.2 Open Api Spec

wat is open api specification

• wat?

  Formaat die de REST-webservice beschrijft

  Geeft een antwoord op:

  • Welke endpoints

  • welke methodes ondersteunen ze

  • welke parameters (in / output)

  • welke authenticatie methodes

  • informatie: contact / licensie

• waarom?

  • beschrijving van interface is onafhankelijjk van programmeer taal

  • snel overzicht functionaliteit

  • ontkoppeling api & implementatie

  • api first approach → consistentere api

  • leesvaar voor machines → handig voor tools

swagger

• swagger Codegen: commentaar uit dcode gebruiken ~ javadocs

  

open api vs swagger

gfd