2015-02-24 3 views
3

Я пытаюсь выяснить, как описать/определить атрибуты/параметры тела запроса для POST/PUT. Вот пример того, что я пытаюсь сделать, но я не могу найти его нигде в документации (хотелось бы, чтобы можно было просмотреть уценку любого публичного документа Apiary): http://docs.bynder.apiary.io/#reference/metaproperties/metaproperty-access/save-new-metapropertyКак указать атрибуты тела запроса в Apiary.io/API Blueprint?

Просмотреть описание и определения атрибутов в разделе «Запрос»? Как мне это сделать?

+1

Когда я нажимаю 'API Blueprint' в заголовке, я получаю [это] (https://jsapi.apiary.io/apis/bynder.apib) в новой вкладке. – slamborne

+0

Как в мире я пропустил это ... Спасибо! – Ian

ответ

5

Ниже приведен пример того, как они, возможно, сделали это. Пожалуйста, взгляните на спецификацию API Blueprint на номер https://github.com/apiaryio/api-blueprint, чтобы узнать больше.

+ 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" 
      } 
+3

Спасибо. Лично я считаю, что спецификация API-документов API совсем неинтуитивна. – Ian

Смежные вопросы