Every now and then you have one of those ah ha moments. I had one of those when checking out the site SchemaStore.org. More specifically when I was checking out their json schemas. Off the bat what I initially liked was:
- Makes it easier for two parties to use the same schema and in turn leads to better interoperability
- Allows you to have intellisense in your editors of choice (assuming they support schema files)
But what I really liked was what some of those schemas provided, more specifically the Swagger API 2.0 schema. What functionality does Swagger provider? At a high level it lets you provide functionality that previously only came with web services, it’s almost like a wsdl file for your Restful API. Essentially it gives a definition of your methods and values and provides the missing piece of functionality that was lost when moving from Web Services to Restful APIs.