restful规范的认识?

首先restful是一种软件架构风格或者说是一种设计风格,并不是标准,它只是提供了一组设计原则和约束条件,主要用于客户端和服务器交互类的软件。
就像设计模式一样,并不是一定要遵循这些原则,而是基于这个风格设计的软件可以更简洁,更有层次,我们可以根据开发的实际情况,做相应的改变。

它里面提到了一些规范,例如:

1.restful 提倡面向资源编程,在url接口中尽量要使用名词,不要使用动词

2、在url接口中推荐使用Https协议,让网络接口更加安全 https://baidum/v1/mycss?page=3 (Https是Http的安全版,即HTTP下加入SSL层,HTTPS的安全基础是SSL, 因此加密的详细内容就需要SSL(安全套接层协议))

3、在url中可以体现版本号 https://v1.bootcss.com/mycss

不同的版本可以有不同的接口,使其更加简洁,清晰

4、url中可以体现是否是API接口 https://baidum/api/mycss

5、url中可以添加条件去筛选匹配 https://baidum/v1/mycss?page=3

6、可以根据Http不同的method,进行不同的资源操作 (5种方法:GET / POST / PUT / DELETE / PATCH)

7、响应式应该设置状态码

8、有返回值,而且格式为统一的json格式

9、返回错误信息

10、返回结果中要提供帮助链接,即API最好做到接口文档

上一篇:用RestFul风格进行传参的时候返回找错地址


下一篇:三种方法实现调用Restful接口