Jos et edelleenkään käytä määrityskieltä koneellisesti luettavissa API-määrityksissä, kuten OpenAPI (aiemmin Swagger), sinun kannattaa ehdottomasti harkita sen käyttöä. Loppujen lopuksi sovellusliittymät ovat kieliä, joilla koneet voivat puhua keskenään.
Onko Swagger hyvä idea?
Swagger tekee erittäin hyvän ensivaikutelman Lisäksi monet ihmiset ajattelevat, että mahdollisuus luoda koodia dokumentaatiosta on hyvä idea, ja Swagger tarjoaa sen yhtä hyvin. Joten se tosiasia, että swagger tekee loistavan ensivaikutelman, tekee sen rajoituksista vähemmän ilmeisiä.
Mikä on Swaggerin käytön tarkoitus?
Swagger sallii sinun kuvailla sovellusliittymiesi rakennetta, jotta koneet voivat lukea ne. Sovellusliittymien kyky kuvata omaa rakennettaan on kaiken Swaggerin mahtavuuden juur.
Käytetäänkö Swaggeria edelleen?
Tänä päivänä monet käyttäjät käyttävät edelleen termejä " Swagger" viittaamaan OpenAPI 2.0 -määritysmuotoon ja "Swagger spec" viittaamaan tässä muodossa olevaan API-kuvausasiakirjaan.. RepreZen API Studio käyttää näitä termejä joissakin käyttöliittymän osissa, mutta viittaa OpenAPI 3.0:aan ja uudempiin versioihin nimellä "OpenAPI ".
Onko swagger vain REST API:lle?
OpenAPI-määritys (aiemmin Swagger-määritys) on API-kuvausmuoto REST-sovellusliittymille. OpenAPI-tiedoston avulla voit kuvata koko API:n, mukaan lukien: Saatavilla olevat päätepisteet (/käyttäjät) ja kunkin päätepisteen toiminnot (GET /käyttäjät, POST /käyttäjät)
