It’s been here for some time, but after a few false starts (the not-so-simple SOAP protocol and WS-BS*) it seems the world has finally agreed on Json/REST as the de-facto protocol or lingua franca of the web.
How do we discover it? Discover has always been an after-thought with REST, but these days most rest frameworks come with built in discovery (at least for human).
Swagger stands on the shoulders of the Json Schema project. With the types announced it’s a stones throw to auto-generate bindings for all the strongly typed languages out there.
Having all these services out there that we rely on is great, but we need to be able to stub them out with fakes. This is where open source projects like mockbin come in. By being able to record and then replay you can isolate yourself from your other (micro)services.
Swagger supports marking bits of your API as deprecated which gives your users a warning they should be upgrading.