restful

SOAP WebService

WebService：是一種跨編程語言和跨操做系統平臺的遠程調用技術。

WebService經過HTTP協議發送請求和接受結果時採用XML格式封裝，並增長了一些特定的HTTP消息頭，這些特定的HTTP消息頭和XML內容就是SOAP協議。

RESTful架構

相對SOAP架構更簡化易用，並未增長額外的http頭，效率也更高，但因爲使用明文驗證，安全性相對較低

 RESTful API設計

資源路徑（URI）：每一個網址表明一種資源，不能含有動詞，並通常使用名詞複數
HTTP動詞：GET, POST, PUT(更新返回完整), PATCH(更新返回更新屬性), DELETE
過濾信息：?offset=10,?page=2&per_page=100,?sortby=name&order=asc,?animal_type_id=1
狀態嗎：200 OK, 201 CREATE 新建或修改爲功, 204 NO CONTENT刪除數據成功， 400 BAD REQUEST, 401 Unauthorized, 403 Forbidden, 422 Unprocessable Entity 驗證失敗, 500 INTERNAL SERVER ERROR
錯誤處理：狀態碼爲4xx,5xx時，返回{error: message}
返回結果：GET/collections:返回數組，GET/coolections/identity：返回對象，POST/collections:返回對象PUT/collections/identity：返回對象，PATCH/collections/identity:返回修改屬性，DELETE/collections/identity:返回空文檔