Par OpenAPI / Swagger skatītājs — Detalizēta rokasgrāmata
OpenAPI Viewer ir klienta puses dokumentācijas lasītājs RESTful API līgumu pārbaudei. Tas renderē Swagger 2.0 un OpenAPI 3.0 / 3.1 specifikācijas JSON vai YAML formātā, neprasot lokālu Swagger UI instalāciju vai mākoņa atkarības.
Tas nodrošina pārskatāmu, grupētu sānu joslas navigāciju visiem galapunktiem, attēlojot ceļus, HTTP metodes (GET, POST, PUT, DELETE), galvenes parametrus, vaicājuma virknes, strukturētus pieprasījumu pamattekstus, HTTP atbilžu kodus un datu shēmas.
Galvenās funkcijas un iespējas
- Atbalsta Swagger 2.0 un OpenAPI 3.0 / 3.1 specifikācijas JSON un YAML formātos
- Interaktīva sānu josla ar kategorizētiem galapunktiem, HTTP metodēm un statusa kodiem
- Dziļa `$ref` shēmu atrisināšana, attēlojot iegultos datu modeļus un īpašību ierobežojumus
- 100% bezsaistes parsēšana klienta pusē, garantējot uzņēmuma patentēto API līgumu drošību
Kā lietot
- 1
Ielīmējiet savu `swagger.json` vai `openapi.yaml` tekstu vai augšupielādējiet specifikācijas failu tieši.
- 2
Pārlūkojiet strukturēto API dokumentāciju, kas renderēta interaktīvajā skatītājā.
- 3
Izvērsiet jebkuru galapunktu, lai pārbaudītu pieprasījuma galvenes, pieprasījuma datu slodzes shēmas un atbilžu paraugus.
Biežākie lietošanas gadījumi
- → Aizmugursistēmas API definīciju audits bez nepieciešamības uzturēt atsevišķu Swagger UI serveri
- → Ar roku rakstītu OpenAPI specifikāciju pārbaude, meklējot nederīgas `$ref` norādes
- → Precīzu shēmu atsauču nodrošināšana priekšgala izstrādātājiem API integrāciju laikā
Saistītie rīki
HTML meta tagu un SEO ģenerators
Ģenerējiet pareizus HTML meta tagus, Open Graph un Twitter Cards sociālajiem tīkliem un meklētājiem.
Gitignore failu ģenerators
Ģenerējiet pilnīgus .gitignore failus pēc operētājsistēmas, valodas un izstrādes rīka.
Atvērtā koda licenču ģenerators
Izvēlieties un ģenerējiet MIT, Apache 2.0, GPL, BSD un citas atvērtā koda licences savam projektam.
README failu veidotājs
Izveidojiet profesionālus projekta README.md dokumentus ar nozīmītēm, sadaļām un instrukcijām.
Conventional Commits veidotājs
Formatējiet standartizētus Git commit ziņojumus atbilstoši Conventional Commits standartam.
Semver versiju kalkulators
Aprēķiniet nākamo semantisko versiju (major, minor, patch) un pārbaudiet atbilstību diapazoniem.
Biežāk uzdotie jautājumi un privātums
Vai šis rīks var tieši nolasīt YAML specifikācijas?
Jā. Iebūvētais YAML parsētājs apstrādā gan `.yaml`, gan `.json` OpenAPI līgumu specifikācijas pilnībā pārlūkprogrammā.
Vai mana patentētā API specifikācija tiek augšupielādēta ārējos serveros?
Nē. Visa dokumentu parsēšana un shēmu renderēšana notiek tikai jūsu vietējās pārlūkprogrammas atmiņā.