請求方法 · HTTP 接口設計指北

## 請求方法 * 如果請求頭中存在?`X-HTTP-Method-Override`?或參數中存在?`_method`（擁有更高權重），且值為`GET`,?`POST`,?`PUT`,?`DELETE`,?`PATCH`,?`OPTION`,?`HEAD`?之一，則視作相應的請求方式進行處理 * `GET`,?`DELETE`,?`HEAD`?方法，參數風格為標準的?`GET`?風格的參數，如?`url?a=1&b=2` * `POST`,?`PUT`,?`PATCH`,?`OPTION`?方法 * 默認情況下請求實體會被視作標準 json 字符串進行處理，當然，依舊推薦設置頭信息的`Content-Type`?為?`application/json` * 在一些特殊接口中（會在文檔中說明），可能允許?`Content-Type`?為?`application/x-www-form-urlencoded`?或者?`multipart/form-data`?，此時請求實體會被視作標準?`POST`?風格的參數進行處理關于方法語義的說明： * `OPTIONS`?用于獲取資源支持的所有 HTTP 方法 * `HEAD`?用于只獲取請求某個資源返回的頭信息 * `GET`?用于從服務器獲取某個資源的信息 * 完成請求后返回狀態碼?`200 OK` * 完成請求后需要返回被請求的資源詳細信息 * `POST`?用于創建新資源 * 創建完成后返回狀態碼?`201 Created` * 完成請求后需要返回被創建的資源詳細信息 * `PUT`?用于完整的替換資源或者創建指定身份的資源，比如創建 id 為 123 的某個資源 * 如果是創建了資源，則返回?`201 Created` * 如果是替換了資源，則返回?`200 OK` * 完成請求后需要返回被修改的資源詳細信息 * `PATCH`?用于局部更新資源 * 完成請求后返回狀態碼?`200 OK` * 完成請求后需要返回被修改的資源詳細信息 * `DELETE`?用于刪除某個資源 * 完成請求后返回狀態碼?`204 No Content` 相關資料： * [RFC 7231 中對請求方法的定義](http://tools.ietf.org/html/rfc7231#section-4.3) * [RFC 5789](http://tools.ietf.org/html/rfc5789)?- PATCH 方法的定義 * [維基百科](http://zh.wikipedia.org/wiki/%E8%B6%85%E6%96%87%E6%9C%AC%E4%BC%A0%E8%BE%93%E5%8D%8F%E8%AE%AE#.E8.AF.B7.E6.B1.82.E6.96.B9.E6.B3.95)