Dicționar IT
Ce este OpenAPI?
Formatul standard în care se descrie complet un API: ce adrese are, ce parametri primește și ce răspunsuri întoarce.
Nimeni nu construiește o casă după descrieri verbale — cere planurile arhitectului, cu fiecare cotă desenată. OpenAPI (fost Swagger) este planșa tehnică a unui API: un fișier standardizat care descrie complet ce adrese există, ce parametri primesc, ce răspunsuri și ce erori întorc. Din acest fișier se generează automat documentație interactivă, cod de client în zeci de limbaje și teste care verifică dacă API-ul își respectă propriul contract. Diferența practică e uriașă: o integrare cu un API documentat OpenAPI începe în ore — partenerul citește specificația și generează codul de legătură; una cu un API descris «prin emailuri» începe cu săptămâni de întrebări. Pentru firma ta, regula e simplă: dacă plătești construcția unui API, cere specificația OpenAPI ca livrabil obligatoriu în contract — e garanția că integrările viitoare și o eventuală schimbare de furnizor nu pornesc de la zero.
Hai să vorbim despre proiectul tău
Scrie-ne pe WhatsApp sau trimite un email — vorbești direct cu un programator.
office@northdan.com · +40 752 070 247
Termenul te interesează pentru un proiect concret? Documentăm și construim API-uri cu specificații OpenAPI — vezi serviciul de integrare API
De ce contează pentru afacerea ta
Integrări care pornesc în ore, nu săptămâni
Partenerii primesc o specificație completă și își generează singuri codul de legătură — dispar lunile de emailuri cu «dar câmpul acesta ce format are?».
Documentație care nu minte niciodată
Documentația interactivă se generează din aceeași specificație pe care rulează API-ul — nu mai există PDF-uri rămase în urmă cu trei versiuni față de realitate.
Contract verificabil automat
Testele compară permanent comportamentul real al API-ului cu specificația — orice abatere se prinde înainte de livrare, nu în producția partenerilor.
Întrebări frecvente
OpenAPI și Swagger sunt același lucru?
Practic da: Swagger a fost numele inițial al specificației, donată în 2015 fundației care a redenumit-o OpenAPI. «Swagger» a rămas numele uneltelor populare din jurul ei — Swagger UI pentru documentație interactivă, Swagger Editor pentru scris specificații.
Specificația OpenAPI se scrie manual?
Ambele abordări există: «design-first» — specificația se scrie întâi și codul o urmează, ideală când mai multe echipe depind de contract; sau generată automat din adnotările din cod, mai comodă la proiecte mici. Important e ca ea să existe și să fie sursa de adevăr.
Ce versiune de OpenAPI ar trebui să cer?
OpenAPI 3.x este standardul curent (3.1 aliniază specificația complet cu JSON Schema); versiunea veche 2.0 mai apare la API-uri legacy. Pentru un proiect nou în 2026, cere explicit 3.1 — uneltele moderne o suportă complet.
Hai să vorbim despre proiectul tău
Scrie-ne pe WhatsApp sau trimite un email — vorbești direct cu un programator.
office@northdan.com · +40 752 070 247