Every now and then you have one of those ah ha moments.  I had one of those when checking out the site 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.



Leave a comment