Sări la conținut
Complet local

Listar puncte finale OpenAPI

Extrageți toate punctele finale dintr-un document OpenAPI sau Swagger ca o tabel lizibil.

Intrare
Ieșire

Listar puncte finale OpenAPI

Lipiți un document OpenAPI sau Swagger — JSON sau YAML, OpenAPI 3 sau Swagger 2 — și acest instrument extrage toate punctele finale într-o listă ușor de citit. Este construit pentru momentul în care primiți un fișier de specificație și aveți nevoie de o privire de ansamblu rapidă înainte de a vă scufunda în detalii: ce rute există, ce au nevoie și ce returnează.

Filtrați lista după metoda HTTP sau după tag pentru a vă concentra pe o parte a API-ului. Comutați parametrii de cale și interogare, tipul de conținut al corpului cererii, codurile de răspuns și dacă un punct final necesită autentificare — instrumentul citește cerințele de securitate per operație, revenind la setarea de securitate globală a documentului atunci când o operație nu o suprascrie. Activați "Sări peste punctele finale depreciate" pentru a ascunde rutele marcate ca depreciate în specificație și includeți câmpul rezumat al fiecărui punct final pentru context suplimentar fără a deschide fișierul sursă.

Sortați rezultatul după cale sau după tag și alegeți un format de ieșire care să corespundă cu ceea ce aveți nevoie în continuare: o listă simplă pentru o scanare rapidă, o tabel Markdown de lipit în documentație sau o cerere pull, sau CSV pentru a deschide într-o foaie de calcul. Parametrii care sunt definiți cu $ref în loc să fie inline sunt omisi decât ghiciți, deoarece rezolvarea unei referințe corect necesită restul documentului.

Totul rulează local în browserul dvs. — specificația API nu parasește niciodată dispozitivul dvs., ceea ce este important atunci când descrie un serviciu intern sau nelansat. Copiați rezultatul, descărcați-l ca fișier .txt sau trimiteți-l direct către un alt instrument pentru a continua munca.

FAQ

Acceptă atât OpenAPI 3 cât și Swagger 2?
Da. Ambele formate păstrează punctele finale sub o secțiune "paths" cu aceeași formă, deci același cititor gestionează ambele versiuni.
Cum decide dacă un punct final necesită autentificare?
Verifică mai întâi câmpul "security" al operației. O matrice goală acolo înseamnă că acel punct final dezactivează în mod explicit autentificarea; dacă câmpul lipsește, instrumentul revine la setarea "security" globală a documentului.
Poate rezolva referințele $ref?
Nu pentru parametri — un parametru definit cu $ref nu are un nume inline, deci este omis decât rezolvat, deoarece aceasta ar necesita citirea restului documentului.
Ce se întâmplă cu un document nevalid sau neînrudit?
Veți vedea un mesaj clar: unul pentru textul care nu este JSON sau YAML valid, și altul când documentul se analizează bine dar nu are o secțiune "paths".
Specificația mea API este încărcată oriunde?
Nu. Analiza și formatarea se întâmplă în întregime în browserul dvs. — documentul pe care îl lipiți nu parasește niciodată dispozitivul dvs.