Использование типичного именованного типа в API Blueprint на Apiary.io

Question

Как я могу использовать generic named type в моем определении Blue API?

Я стараюсь, как это:

FORMAT: 1A HOST: http://test.com/ 

# API Blueprint testing. 

## Resource [/resources] 
### Action [GET] 

+ Response 200 (application/json) 

    + Attributes 
     + decorated_person (Address Decorator(Person)) 


# Data Structures 

## Person (object) 
+ first_name 
+ last_name 

## Address Decorator (*T*) 
+ address 

Но Пасека редактор дает мне ошибку:

base type 'Address Decorator(Person)' is not defined in the document

Answer 1

здесь две проблемы. Адрес Decorator не является базовым типом, например объектом, а в атрибутах вы должны использовать Mixin или Nesting.

FORMAT: 1A 

HOST: http://test.com/ 

# API Blueprint testing. 

## Resource [/resources] 
### Action [GET] 

+ Response 200 (application/json) 

    + Attributes 
     + Include AddressDecorator 


# Data Structures 

## Person (object) 
+ first_name 
+ last_name 

## AddressDecorator (object) 
+ address