Ja joprojām neizmantojat definīciju valodu mašīnlasāmām API specifikācijām, piemēram, OpenAPI (iepriekš zināma kā Swagger), noteikti apsveriet iespēju to darīt. Galu galā API ir valodas, kurās mašīnas var sarunāties savā starpā.
Vai Swagger ir laba ideja?
Swagger atstāj ļoti labu pirmo iespaidu Turklāt daudzi cilvēki domā, ka iespēja ģenerēt kodu no dokumentācijas ir laba ideja, un Swagger nodrošina, ka arī. Tāpēc fakts, ka svaidīšana rada lielisku pirmo iespaidu, padara tās ierobežojumus un ierobežojumus mazāk pamanāmus.
Kāds ir Swagger izmantošanas mērķis?
Swagger ļauj aprakstīt jūsu API struktūru, lai mašīnas varētu tās nolasīt. API spēja aprakstīt savu struktūru ir visu Swagger izcilību pamatā.
Vai Swagger joprojām tiek izmantots?
Šodien daudzi lietotāji joprojām lieto terminus " Swagger", lai atsauktos uz OpenAPI 2.0 specifikācijas formātu, un "Swagger spec", lai atsauktos uz API apraksta dokumentu šajā formātā.. RepreZen API Studio izmanto šos terminus dažās lietotāja saskarnes daļās, bet uz OpenAPI 3.0 un jaunākām versijām attiecas kā "OpenAPI ".
Vai swagger ir paredzēts tikai REST API?
OpenAPI specifikācija (iepriekš Swagger specifikācija) ir API apraksta formāts REST API. OpenAPI fails ļauj aprakstīt visu jūsu API, tostarp: pieejamos galapunktus (/users) un darbības katrā galapunktā (GET /lietotāji, POST /lietotāji)
