Ako još uvijek ne koristite jezik definicije za strojno čitljive API specifikacije, kao što je OpenAPI (ranije poznat kao Swagger), svakako biste trebali razmisliti o tome. Na kraju krajeva, API-ji su jezici za mašine da razgovaraju jedni s drugima.
Je li Swagger dobra ideja?
Swagger ostavlja vrlo dobar prvi utisak Osim toga, mnogi ljudi misle da je mogućnost generiranja koda iz dokumentacije dobra ideja i Swagger to pruža takođe. Dakle, činjenica da razmetljivost ostavlja odličan prvi utisak, čini svoja ograničenja i ograničenja manje očiglednima.
Koja je svrha korištenja Swaggera?
Swagger omogućava vam da opišete strukturu vaših API-ja tako da ih mašine mogu čitati. Sposobnost API-ja da opišu sopstvenu strukturu je koren svih sjaja u Swaggeru.
Da li se Swagger još uvijek koristi?
Danas, mnogi korisnici još uvijek koriste izraze " Swagger" za upućivanje na format specifikacije OpenAPI 2.0 i "Swagger spec" za upućivanje na dokument opisa API-ja u ovom formatu. RepreZen API Studio koristi ove termine u nekim dijelovima korisničkog sučelja, ali se odnosi na OpenAPI 3.0 i novije verzije kao "OpenAPI. "
Je li swagger samo za REST API?
OpenAPI Specifikacija (ranije Swagger Specifikacija) je format opisa API-ja za REST API-je. OpenAPI datoteka vam omogućava da opišete cijeli API, uključujući: Dostupne krajnje tačke (/users) i operacije na svakoj krajnjoj tački (GET /users, POST /users)