You can already describe URI parameters in structured way with the new API Blueprint format. Refer to https://github.com/apiaryio/api-blueprint/blob/master/examples/7.%20Parameters.md for details.
The new format is now default and URI parameters are properly rendered in the documentation.
We are still working on description of http message–body properties (parameters). It is planned in the upcoming revision 1B of API Blueprint – as discussed in https://github.com/apiaryio/api-blueprint/issues/25Tobias Kopelke commented
I'm not sure how to have optional static parts in my url
These should work and return the same resource, just differently formatted:
I'd write it like this
in apiary I could write it like this-ish:
or do I need to create to API descriptions for the same resource?