Hvis du fortsatt ikke bruker et definisjonsspråk for maskinlesbare API-spesifikasjoner, for eksempel OpenAPI (tidligere kjent som Swagger), bør du definitivt vurdere å gjøre det. Når alt kommer til alt, er API-er språk for maskiner for å snakke med hverandre.
Er Swagger en god idé?
Swagger gir et veldig godt førsteinntrykk Dessuten tror mange at muligheten til å generere kode ut av dokumentasjonen er en god idé, og Swagger sørger for at også. Så det faktum at swagger gjør et godt førsteinntrykk, gjør dets begrensninger og begrensninger mindre tydelige.
Hva er hensikten med å bruke Swagger?
Swagger lar deg beskrive strukturen til API-ene dine slik at maskinene kan lese dem. API-enes evne til å beskrive sin egen struktur er roten til alt det fantastiske i Swagger.
Brukes Swagger fortsatt?
I dag bruker mange brukere fortsatt begrepene " Swagger" for å referere til OpenAPI 2.0-spesifikasjonsformatet, og "Swagger spec" for å referere til et API-beskrivelsesdokument i dette formatet. RepreZen API Studio bruker disse begrepene i enkelte deler av brukergrensesnittet, men refererer til OpenAPI 3.0 og senere versjoner som "OpenAPI. "
Er swagger bare for REST API?
OpenAPI-spesifikasjon (tidligere Swagger-spesifikasjon) er et API-beskrivelsesformat for REST APIer. En OpenAPI-fil lar deg beskrive hele API-en din, inkludert: Tilgjengelige endepunkter (/brukere) og operasjoner på hvert endepunkt (GET /brukere, POST /brukere)
