Extensions

Extensions

I love API Blueprint but it is missing some stuff I found to be awesome

Including Files

It is possible to include other files in your blueprint by using a special include directive with a path to the included file relative to the current file's directory. Included files can be written in API Blueprint, Markdown or HTML (or JSON for response examples). Included files can include other files, so be careful of circular references.

<!-- include(filename.md) -->

For tools that do not support this include directive it will just render out as an HTML comment. API Blueprint may support its own mechanism of including files in the future, and this syntax was chosen to not interfere with the external documents proposal while allowing PHPDraft users to include documents today.

Thanks to aglio for the idea.

HOSTS

Apiary allows you to set a HOST keyword in your metadata, this allows them to generate requests for you. That's pretty cool but you know what's even cooler? Selecting anything in your DTAP stack from a dropdown.... Yup, we allow that. Just use comma seperated hosts in your file. They'll be added to the HOST parameter you probably already had defined for optimal compatibility.

ALT_HOST:https://dev.google.com,https://acc.google.com