Hvis du stadig ikke bruger et definitionssprog til maskinlæsbare API-specifikationer, såsom OpenAPI (tidligere kendt som Swagger), bør du bestemt overveje at gøre det. Når alt kommer til alt, er API'er sprog, hvor maskiner kan tale med hinanden.
Er Swagger en god idé?
Swagger giver et meget godt førstehåndsindtryk Desuden synes mange mennesker, at muligheden for at generere kode ud af dokumentationen er en god idé, og Swagger sørger for, at såvel. Så det faktum, at swagger giver et godt første indtryk, gør dets begrænsninger og begrænsninger mindre tydelige.
Hvad er formålet med at bruge Swagger?
Swagger giver dig mulighed for at beskrive strukturen af dine API'er, så maskinerne kan læse dem. API'ernes evne til at beskrive deres egen struktur er roden til al awesomeness i Swagger.
Bruges Swagger stadig?
I dag bruger mange brugere stadig udtrykkene " Swagger" for at henvise til OpenAPI 2.0-specifikationsformatet og "Swagger spec" for at henvise til et API-beskrivelsesdokument i dette format. RepreZen API Studio bruger disse udtryk i nogle dele af brugergrænsefladen, men henviser til OpenAPI 3.0 og senere versioner som "OpenAPI. "
Er swagger kun for REST API?
OpenAPI Specification (tidligere Swagger Specification) er et API-beskrivelsesformat for REST API'er. En OpenAPI-fil giver dig mulighed for at beskrive hele din API, inklusive: Tilgængelige slutpunkter (/brugere) og operationer på hvert slutpunkt (GET /brugere, POST /brugere)
