Press "Enter" to skip to content

Category: Coding

REST API Style 接口设计

REST(Representational State Transfer)是一种基于HTTP协议的数据交换方法。按照RESTful架构可以充分的利用HTTP协议带给我们的各种功能,算是对HTTP协议使用的最佳实践,还有一点就是可以使软件架构设计更加清晰,可维护性更好。 架构特性: 幂等性:幂等性(Idempotence)本身是一个数学概念,在HTTP/1.1规范中幂等性的定义是:

翻译过来大意就是如果方法调用一次和多次产生额外的效果是相同的,它就具有幂等性。 例子:在HTTP中使用GET方法通常用于从服务器获取资源,无论调用多少次产生的额外效果都是从服务器获取资源,所以GET具有幂等性;而POST方法通常用于提交数据在服务器上创建一个资源,由于最终创建的结果每次都是不同的,所以POST不具有幂等性;但是PUT方法却是幂等的,因为每次调用产生的效果都是对资源进行更新。 安全方法:安全方法是指不修改资源的 HTTP 方法。譬如,当使用 GET 或者 HEAD 作为资源 URL,都必须不去改变资源。然而,这并不全准确。意思是:它不改变资源的 表示形式。对于安全方法,它仍然可能改变服务器上的内容或资源,但这必须不导致不同的表现形式。 有关HTTP常用方法幂等性和安全性如下:   RESTful API设计规则:1. URI 应该将API部署在专用域名之下:https://api.example.com 不用大写 用中杠-不用下杠_;…

Leave a Comment