Apiary で定義された API コントラクトがあり、リソース モデル構文を使用してペイロードの再利用を有効にしています。
ただし、Apiary によってレンダリングされたドキュメントにはモデル名のみが表示されます (たとえば、Response 200 は [Foo][] を返します)。Foo とは何かについての詳細や、Foo モデルの属性を表示するためのリンクはありません。
モデルが与えられた場合、レンダリングされたドキュメントでそのモデルの属性を確認するにはどうすればよいですか?
更新
契約の関連部分は以下のとおりです。
### Manipulating a specific Organisation [/organisations/{id}]
Operations to retrieve and update a specific Organisation.
+ Parameters
+ id (required, guid, `F339ADA5-E836-40FE-8E90-BEF06892762E`) ... The guid Organisation `id`.
+ Model (application/json)
+ Headers
Link : <http://foobar.com/organisations/F339ADA5-E836-40FE-8E90-BEF06892762E>;rel="self"
+ Body
{
"id" : "F339ADA5-E836-40FE-8E90-BEF06892762E",
"name" : "joe's gardening supplies"
}
### Retrieve an Organisation [GET]
+ Response 200
[Organisation][]
### Update an Organisation [PATCH]
+ Request
[Organisation][]
+ Response 204