The new API Blueprint has officially arrived at Apiary. The API Blueprint is a documentation-oriented API description language that drives everything in Apiary. Today I am proud to announce the availability of its new, from the ground redesigned, version at Apiary.
While it might take a bit more time before the new API Blueprint becomes the default format of Apiary you can already opt-in today. To get started with the new API Blueprint simply sign in to Apiary.io, create a new API and start with the
FORMAT: 1A line. Visit the API Blueprint Tutorial for a quick dive into its syntax.
API Blueprint builds upon the legacy of the original API Blueprint format. It remains the perfect lightweight form for capturing ideas about your new API while delivering robustness, readability, scaleability and DRY-ness.
Its new parser takes care of helping you throughout the API design process giving you reasonable explanations instead of just the infamous
"Me explode" message should a syntax problem occur.
Both the API Blueprint and its reference parser are completely open sourced.
In addition, you are more than welcome to use the API Blueprint, its parser or the tools built on top of it at any point in your own toolchain. Just do not forget to to let the API Blueprint community know!
The new API Blueprint represent such a great update to the current API Blueprint that not all of its features has been yet fully embraced within the Apiary. All of these, including the automated conversion from the legacy format to the new one, will arrive during the course of this autumn.
We constantly strive to deliver you the single best experience designing your API and we believe the new API Blueprint is such an awesome leap forward.