Swagger: A simple, open standard for describing REST APIs with JSON

Have you ever work with API with really bad documentation? I do, Facebook API is one example. I really wish they could look at this and document their facebook api with this tools. User can play with the API right inside the documentation! Swagger: A simple, open standard for describing REST APIs with JSON