How do you specify request body attributes in Apiary.io / API Blueprint?

Question

I'm trying to figure out how to describe/define the request body attributes/parameters for POST/PUT. Here is an example of what I'm trying to do, but I can't find it anywhere in the documentation (I wish there was a way to view the markdown of any public Apiary doc): http://docs.bynder.apiary.io/#reference/metaproperties/metaproperty-access/save-new-metaproperty

See the description and attribute definitions under the "Request" section? How do I do that?

When I click `API Blueprint` in the header, I get [this](https://jsapi.apiary.io/apis/bynder.apib) in a new tab. — slamborne, Mar 05 '15 at 20:16

score 8 · Accepted Answer · answered Feb 24 '15 at 08:42

8

Below is how they have probably done it. Please take a look at the API Blueprint specification at https://github.com/apiaryio/api-blueprint to know more.

+ Request (application/json)

    You can have any description here. This is based on markdown.

    + Even a list
    + `name` Name of the metaproperty, should be alphanumeric only. Uneditable.

    + Body

            {
              "name": "app"
            }

answered Feb 24 '15 at 08:42

Pavan Kumar Sunkara

3,025
21
30

4

Thanks. Personally, I find the API Blueprint spec/docs quite unintuitive. – booshong Feb 24 '15 at 18:57

How do you specify request body attributes in Apiary.io / API Blueprint?

1 Answers1