OpenAPI/Swagger-generator

Bygger en OpenAPI 3.0.0-spesifikasjon som pent formatert JSON fra API-metadata (tittel, versjon, beskrivelse, grunn-URL) og en liste over endepunkter. Hvert endepunkt inneholder en HTTP-metode, sti, sammendrag, parametere (query/path/header/cookie), valgfri forespørselskropp og et svarkart; utdataene vises på Forhåndsvisning-fanen med en kopieringsknapp.

1. På Info-fanen fyller du inn Tittel, Versjon, Beskrivelse og Grunn-URL (brukes som servers[0].url). 2. På Endepunkter-fanen klikker du Legg til for å opprette et nytt endepunktkort. 3. Klikk på et kort for å åpne Rediger endepunkt-skjemaet og angi Sti, Metode (GET/POST/PUT/DELETE/PATCH), Sammendrag og Beskrivelse. 4. Åpne Forhåndsvisning-fanen for å lese den live JSON-en og klikk Kopier.

Endepunkter grupperes under stier etter stistrengen deres. Hver operasjon er nøkkelbetegnet med metoden i små bokstaver (get, post, put, delete, patch) under sti-elementet. Parametere blir {name, in, schema:{type}, required, description}-oppføringer. Når en forespørselskropp finnes, utstedes den som innhold nøkkelbetegnet med innholdstypen og et generisk objektskjema. Responses-objektet utstedes ordrett fra svarkartet ditt.