What is Swagger and does it relate to OData? -
i familiar microsoft stack. using odata of restful services. came across swagger api documentation , trying understand how relates odata. both of them seem restful specifications. 1 used?
swagger specification documenting apis. creating swagger document api, can pass instance of swagger ui, renders document in neat, readable format , provides tooling invoke apis. see swagger.io website further information.
odata specification creating data services on http, defines how service should constructed , patterns should follow. example, use of $top directive provide first n results of data set. odata @ version 4, v2 documentation has very overview.
swashbuckle nuget package microsoft stack produces swagger documents api's automatically, based on inspecting code , additional metadata provide shape output document.
if want swashbuckle automatically generate swagger documents odata api building, can use swashbuckle.odata provide you.
i hope helps clear confusion.
Comments
Post a Comment