Download OpenAPI specification:Download
這是一個學習如何使用 Swagger 產生 API Document 的範例。
如何描述在 body 或 header 的參數
authorization | string Example: "acde1jflk34fd21ekfkf" 參數在 header 中的例子,此處以 authorization 為例 |
propString | string 這是一個字串的參數 |
propInt | int 這是一個整數的參數 |
propBoolean | boolean 這是一個布林值的參數 |
propArray | Array of any 這是一個陣列的參數 |
propObject | object 這是一個物件的參數 |
Default response
definition 是可以重複使用的物件簡寫,可以用 "$ref" : "#/definitions/modelName"
存取
這是一個成功 Response 的例子
缺少參數或參數格式不正確
帳號或密碼錯誤
definition 可以描述各種層級,也可以直接在參數層級定義 definition
propString | string 這是一個字串的參數 |
propInt | int 這是一個整數的參數 |
propBoolean | boolean 這是一個布林值的參數 |
propArray | Array of any 這是一個陣列的參數 |
propObject | object 這是一個物件的參數 |
Default response