Kui te ikka ei kasuta masinloetavate API spetsifikatsioonide jaoks määratluskeelt, näiteks OpenAPI-d (varem tuntud kui Swagger), peaksite seda kindlasti kaaluma. Lõppude lõpuks on API-d keeled, mille abil masinad saavad omavahel rääkida.
Kas Swagger on hea mõte?
Swagger jätab väga hea esmamulje Pealegi arvavad paljud, et võimalus dokumentatsioonist koodi genereerida on hea mõte ja Swagger annab selle samuti. Nii et tõsiasi, et swagger jätab suurepärase esmamulje, muudab selle piirangud ja piirangud vähem ilmseks.
Mis on Swaggeri kasutamise eesmärk?
Swagger võimaldab teil kirjeldada oma API-de struktuuri, et masinad saaksid neid lugeda. API-de võime kirjeldada oma struktuuri on kogu Swaggeri vinge juur.
Kas Swaggerit kasutatakse ikka veel?
Tänapäeval kasutavad paljud kasutajad endiselt termineid " Swagger", et viidata OpenAPI 2.0 spetsifikatsioonivormingule, ja "Swaggeri spetsifikatsioon" selles vormingus API kirjeldusdokumendile viitamiseks. RepreZen API Studio kasutab neid termineid kasutajaliidese mõnes osas, kuid viitab OpenAPI 3.0 ja uuematele versioonidele kui "OpenAPI ".
Kas swagger on ainult REST API jaoks?
OpenAPI spetsifikatsioon (endine Swaggeri spetsifikatsioon) on API kirjeldusvorming REST API-de jaoks. OpenAPI-fail võimaldab teil kirjeldada kogu API-t, sealhulgas: saadaolevaid lõpp-punkte (/kasutajad) ja iga lõpp-punkti toimingud (GET /kasutajad, POST /kasutajad)
