Dacă încă nu utilizați un limbaj de definiție pentru specificațiile API care pot fi citite de mașină, cum ar fi OpenAPI (cunoscut anterior ca Swagger), ar trebui să vă gândiți să faceți acest lucru. La urma urmei, API-urile sunt limbi prin care mașinile pot vorbi între ele.
Este Swagger o idee bună?
Swagger face o primă impresie foarte bună În plus, mulți oameni cred că posibilitatea de a genera cod din documentație este o idee bună, iar Swagger prevede că de asemenea. Așadar, faptul că fanfașul face o primă impresie grozavă face limitările și constrângerile sale mai puțin evidente.
Care este scopul utilizării Swagger?
Swagger vă permite să descrieți structura API-urilor dvs., astfel încât mașinile să le poată citi. Capacitatea API-urilor de a-și descrie propria structură este rădăcina tuturor minunatelor din Swagger.
Se mai folosește Swagger?
Astăzi, mulți utilizatori încă folosesc termenii „ Swagger” pentru a se referi la formatul specificației OpenAPI 2.0 și „Swagger spec” pentru a se referi la un document de descriere API în acest format. RepreZen API Studio folosește acești termeni în unele părți ale interfeței de utilizare, dar se referă la OpenAPI 3.0 și la versiunile ulterioare ca „OpenAPI”.
Este swagger numai pentru API-ul REST?
Specificația OpenAPI (fosta Swagger Specification) este un format de descriere API pentru API-urile REST. Un fișier OpenAPI vă permite să descrieți întregul dvs. API, inclusiv: punctele finale disponibile (/utilizatori) și operațiunile pe fiecare punct final (GET /utilizatori, POST /utilizatori)
