Swagger

swagger-hero

Speaking of APIs and documentation in the previous post:

Swagger is a specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services.

Describe your API in a JSON file like this, and Swagger will turn it into that. Alternatively you can provide your project with Swagger Annotations and then run it through a parser (such as Swagger-PHP) to let it automatically generate the docs.

Swagger →
Swagger-PHP →

Related: Simple REST API Explorer, my attempt to quickly allow one to consume a RESTful/Hypermedia API.

Published by Bramus!

Bramus is a frontend web developer from Belgium, working as a Chrome Developer Relations Engineer at Google. From the moment he discovered view-source at the age of 14 (way back in 1997), he fell in love with the web and has been tinkering with it ever since (more …)

Leave a comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.