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:返回空文档