Ho familiarità con lo stack Microsoft. Sto usando OData per alcuni dei miei servizi di riposo. Recentemente mi sono imbattuto in Swagger per la documentazione dell'API e sto cercando di capire come si rapporta a OData. Entrambi sembrano essere specifiche RESTful. Quale è ampiamente usato?Cos'è Swagger e si riferisce a OData?
risposta
Swagger è una specifica per API di documentazione. Creando un documento di swagger per la tua API, puoi passarlo a un'istanza dell'interfaccia utente di Swagger, che esegue il rendering del documento in un formato ordinato e leggibile e fornisce strumenti per richiamare le tue API. Vedere il sito Web swagger.io per ulteriori informazioni.
OData è una specifica per la creazione di servizi dati su HTTP, si definisce come un servizio deve essere costruito e quali modelli si dovrebbe seguire. Ad esempio, l'uso della direttiva $ top per fornire i primi n risultati di un set di dati. OData è attualmente alla versione 4, ma la documentazione di v2 ha un very good overview.
Swashbuckle is a nuget package per Microsoft stack che produce documenti spavalderia per il vostro API automaticamente, sulla base di ispezionare il codice e metadati aggiuntivi che fornisci a plasmare il documento di output.
Se si desidera Swashbuckle per generare automaticamente i documenti spavalderia di un'API OData si sta creando, quindi è possibile utilizzare Swashbuckle.OData di fornire questo per voi.
Spero che questo aiuti a chiarire ogni confusione.
- 1. Come documentare endpoint OData (swagger, swashbuckle, altro)?
- 2. In clojure, is (= 'a' a) si riferisce allo 'stesso atomo'?
- 3. Esistono alternative a OData?
- 4. In che modo Angular JS si riferisce a Google Closure?
- 5. cosa fa questa informazione di wirehark si riferisce a
- 6. A cosa si riferisce un vettore C++ in Objective-C?
- 7. Quale limite di std :: async si riferisce a Stroustrup?
- 8. La parola chiave Binding si riferisce a cosa?
- 9. A cosa si riferisce "questo" nelle funzioni freccia in ES6?
- 10. A cosa si riferisce il valore restituito da arrayIndexScale?
- 11. Un typedef che si riferisce a se stesso
- 12. In Ruby, a cosa si riferisce il "destinatario"?
- 13. A cosa si riferisce "sé" in un @classmethod?
- 14. Swagger e Date
- 15. pip3.4 -V si riferisce alla installazione python2.7
- 16. In che modo C++ gestisce un const const e questo si riferisce a un int?
- 17. Cosa significa il termine "ciclo vuoto" si riferisce esattamente a C e C++?
- 18. odata - annidato $ selezionare e $ espandere
- 19. OData e distinzione tra maiuscole e minuscole
- 20. C'è una domanda odata a LINQ in cui l'espressione (OData a LINQ)
- 21. git dietro delega: a distanza HEAD si riferisce a ref inesistente, incapace di cassa
- 22. git Avviso: HEAD remoto si riferisce a ref inesistente, impossibilitato a pagare
- 23. Web Api 2.2 con odata e $ expand
- 24. Differenza tra servizi web OData e REST
- 25. JavaScript si riferisce alla finestra anziché alla funzione oggetto all'interno
- 26. webApi2 Odata v3 e V4 affiancati
- 27. Come si associa una query OData a un DTO a un'entità EF?
- 28. API Web e OData-Pass Parametri multipli
- 29. Componente figlio 2 angolare si riferisce al componente principale
- 30. kendo gridview e web api odata