RAML：引用資源中的uriParameters

我正在寫RAML中的API規範，並且想知道是否可以引用uri參數來創建動態MIME類型。沿着RAML：引用資源中的uriParameters

baseUri: http://api.mycompany.com/{version} 

/first_resource: 
    get: 
    responses: 
     200: 
     body: 
      application/custom.mime.type.{version}+json

來源

2014-04-09 Matt

目前的東西線（V 0.8）這樣的行爲是不spec的一部分。

您在示例代碼中的內容可能會爲開發人員添加一條錯誤路徑 - 您的服務器實現將不得不迎合：如果某個資源的請求位於http://api.mycompany.com/v1處，但由於某些原因會發生什麼情況包含一個Content-Type: custom.mime.type.v2+json -Header？

當使用定製版本化的MIME類型時，我的建議是有一個非版本化的URL來避免這種設計情況。對於無法發送所需標題的客戶端，您仍然可以使用查詢字符串或您擁有的內容提供後備...

來源

2014-07-21 00:39:00 Philzen

RAML：引用資源中的uriParameters

回答

相關問題