API Blueprint - アトリビュートのないレスポンスでData Strucutresを使用

Question

私はApiaryを使って新しいAPIを模擬しています。

私はすべてのJSON応答を繰り返し書き出す必要がないようにしようとしています。私が+ Attributes(user)を使用してそれを行うと、機械パネルの属性ブロックが自動的に生成されます（特に複数の応答がある場合）。

JSONリクエスト/レスポンスブロックを手作業で書き出すと、結果として得られるドキュメントがより良く見えます。

リクエスト/レスポンスオブジェクトをデータ構造として保存する方法はありますか？おそらくモデルでしょうか？

私はこのような何かをできるようにしてみたい：

## Users [/auth] 
A user object contains the these attributes. 

+ Attributes (user) <!-- I like this here --> 

### Refresh a token for a user [POST /auth/refresh] 

+ Request (application/json) 
    + Headers 

      Authorization: Bearer jsonWebToken 


+ Response 200 (application/json)   
    + Body 

      { 
       "data": [ 
        (user) <!-- I wish this was the user data structure as JSON --> 
       ], 
       "meta": { 
        "access_token": "jsonWebToken", 
        "token_type": "Bearer", 
        "expires_in": 3600 
       } 
      } 



# Data Structures 

## user (object) 
+ id: 123 (number) 
+ email: drew@funkhaus.us 

注：userオブジェクトは、実際の生活の中で30個の属性の長さです。

Answer 1

これはサポートされているシナリオではありませんが、データ構造はJSONのペイロードにはできません。

私が正しく理解していれば、属性を使用しても問題ありませんが、ドキュメントでは非表示にしたいと考えています。それを確認できますか？