Ok, sullo
schermo ho l'account GitHub per la specifica OpenAPI.
È qui che risiede tutto il codice sorgente di OpenAPI.
Si trova all'interno di questo repository GitHub.
Vi fornirò un link nelle risorse del corso, in modo che possiate andare direttamente qui.
Ora, ci sono alcune cose che voglio sottolineare qui, specificamente
per il corso che stiamo per vedere. Se si entra qui e si dà un'occhiata alla cartella degli esempi all'interno di GitHub si può
vedere che abbiamo la versione 2. 0 e 3. 0.
Ancora una volta non mi sto concentrando su 2. 0, ma io ne guarderò 3. 0.
Ecco una serie di esempi diversi.
Ricordate che abbiamo guardato il petstore, quindi ecco il petstore. YAML ha le specifiche OpenAPI.
Si può notare che ci sono diverse implementazioni della specifica OpenAPI che possiamo esaminare.
Per questo motivo, quando avete bisogno di vedere come fare qualcosa,
potete passare in rassegna questi esempi e tornare qui. Poi vogliamo dare un'occhiata a queste IMPLEMENTAZIONI, questo
file markdown qui IMPLEMENTAZIONI. Si tratta di implementazioni note per OpenAPI3. 0.
Possiamo vedere che sono stati impostati diversi utensili in diversi programmi disponibili.
Questo elenco è in continua crescita. Consiglio vivamente di darci un'occhiata e sono disponibili
diverse tecnologie.
Sono principalmente uno sviluppatore Java, quindi è possibile vedere una serie di strumenti Java.
So a malapena scrivere Ruby, ma ci sono strumenti Ruby, Node. js, Typescript, PHP. Abbiamo quindi a disposizione un gran
numero di strumenti.
Ricordate che ho detto che useremo l'editor di SwaggerHub.
Ecco alcuni strumenti specifici per lavorare con OpenAPI.
Alcuni editori specifici. A molti piace Visual Studio.
In realtà ho usato questa qui in cima all'estensione di Visual Studio Code, che è molto bella. Pertanto, si potrebbe preferire l'uso di
Sisual Studio.
Si tratta di uno strumento gratuito che è un editoriale che si può utilizzare.
E in realtà ne conosco alcuni che non sono disponibili qui, quindi questo non è assolutamente un elenco completo, ci sono
altri strumenti che non sono presenti in questo elenco.
Poi si può vedere qui Interfacce utente.
Si tratta quindi di strumenti che verranno inseriti nelle specifiche OpenAPI e di cui vi forniremo la documentazione.
Abbiamo quindi già visto swagger-ui in azione.
Ed ecco alcune opzioni aggiuntive.
Quindi, Widdershins è un'idea piuttosto popolare.
Per quanto riguarda la generazione di documentazione per l'utente finale dalle specifiche OpenAPI, personalmente apprezzo molto
Redoc.
Si tratta di un ottimo strumento per la generazione di documentazione per l'utente a partire dalle specifiche OpenAPI e ora è
possibile vedere che abbiamo implementazioni di server, implementazioni di client e generatori di codice.
Esistono quindi diversi generatori di codice che si possono utilizzare con le specifiche OpenAPI.
Riportiamola qui.
E ricordate che ho detto che la specifica OpenAPI è supportata da uno schema formale.
Ecco lo schema JSON.
Se si vuole andare a vedere esattamente,
è qui che si può dare un'occhiata a come viene definito lo schema OpenAPI, questo è il codice sorgente grezzo per così dire,
ma lo vedremo con un approccio diverso. Non mi dilungherò troppo su questo
punto, ma tornate qui e infine vi consiglio vivamente di consultare la documentazione,
che è molto ricca.
È possibile vedere gli strumenti e le librerie di partecipazione, come è stato concesso in licenza, se si vuole contribuire a questo progetto,
che è un progetto open source.
Hanno anche un comitato tecnico direttivo che sta sviluppando delle linee guida, per cui, ovviamente, non ho intenzione di passare
in rassegna ogni singola cosa, ma stiamo solo parlando di cercare di raggiungere OpenAPI e potete vedere che
al momento siamo a quota 3. 0. 2.
E se clicco su questo, il link mi porterà in due versioni.
Quindi, ma farò clic su questo.
Questa è la documentazione dello schema OpenAPI, con la quale prenderemo molta confidenza.
In particolare, ci occuperemo dello sviluppo rispetto allo schema OpenAPI
e di un oggetto specifico come l'oggetto OpenAPI. Come si può vedere, questa è la specifica dello schema di primo livello,
che verrà analizzata nei prossimi video.
La documentazione di OpenAPI è molto ricca, molto dettagliata e va considerata come l'unica
fonte di verità quando si lavora con la documentazione di OpenAPI.