Как использовать RESPONSE в Apiary

Question

Есть ли способ повторного использования RESPONSE в Пасеке? Я думаю, что Data Structures - это не правильный путь, но я не могу найти что-либо еще ...

Answer 1

Структуры данных - как вы, вероятно, заметили сначала, как немного перебор, но это точный ответ находясь в поиске. Если вы больше заинтересованы в том, как использовать их в «расширенном режиме», пожалуйста, смотрите на учебник по https://github.com/apiaryio/api-blueprint/blob/master/Advanced%20Tutorial.md#data-structures

Другой вариант заключается в использовании ресурсов Модель:

## My Message [/message] 

+ Model (application/vnd.siren+json) 

    This is the `application/vnd.siren+json` message resource representation. 

    + Headers 

      Location: http://api.acme.com/message 

    + Body 

      { 
       "class": [ "message" ], 
       "properties": { 
        "message": "Hello World!" 
       }, 
       "links": [ 
        { "rel": "self" , "href": "/message" } 
       ] 
      } 

Другой вариант нам использовать простые атрибуты (https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md#resource-attributes-description)

# Blog Post [/posts/{id}] 
Resource representing **ACME Blog** posts. 

+ Attributes 
    + id (number) 
    + message (string) - The blog post article 
    + author: john@appleseed.com (string) - Author of the blog post 

И позже, обратитесь к ^^^ "актив", как написано ниже:

+ Attributes (Blog Post)