首先restful是一种软件架构风格或者说是一种设计风格,并不是标准,它只是提供了一组设计#原则和约束条件,主要用于客户端和服务器交互类的软件。
就像设计模式一样,并不是一定要遵循这些原则,而是基于这个风格设计的软件可以更简洁,更#有层次,我们可以根据开发的实际情况,做相应的改变。
它里面提到了一些规范,例如:
1.restful 提倡面向资源编程,在url接口中尽量要使用名词,不要使用动词
2、在url接口中推荐使用Https协议,让网络接口更加安全
3、在url中可以体现版本号https://v1.bootcss.com/mycss不同的版本可以有不同的接口,使其更加简洁,清晰
4、url中可以体现是否是API接口 https://www.bootcss.com/api/mycss
5、url中可以添加条件去筛选匹配https://www.bootcss.com/v1/mycss?page=3
6、可以根据Http不同的method,进行不同的资源操作(5种方法:GET / POST / PUT / DELETE / PATCH)
7、响应式应该设置状态码
8、有返回值,而且格式为统一的json格式
9、返回错误信息返回值携带错误信息
10、返回结果中要提供帮助链接,即API最好做到Hypermedia如果遇到需要跳转的情况 携带调转接口的URL
ret = {
code: 1000,
data:{
id:1,
name:'小强',
depart_id:http://www.luffycity.com/api/v1/depart/8/
}
首先restful是一种软件架构风格或者说是一种设计风格,并不是标准,它只是提供了一组设计#原则和约束条件,主要用于客户端和服务器交互类的软件。
就像设计模式一样,并不是一定要遵循这些原则,而是基于这个风格设计的软件可以更简洁,更#有层次,我们可以根据开发的实际情况,做相应的改变。
它里面提到了一些规范,例如:
1.restful 提倡面向资源编程,在url接口中尽量要使用名词,不要使用动词
2、在url接口中推荐使用Https协议,让网络接口更加安全
3、在url中可以体现版本号https://v1.bootcss.com/mycss不同的版本可以有不同的接口,使其更加简洁,清晰
4、url中可以体现是否是API接口 https://www.bootcss.com/api/mycss
5、url中可以添加条件去筛选匹配https://www.bootcss.com/v1/mycss?page=3
6、可以根据Http不同的method,进行不同的资源操作(5种方法:GET / POST / PUT / DELETE / PATCH)
7、响应式应该设置状态码
8、有返回值,而且格式为统一的json格式
9、返回错误信息返回值携带错误信息
10、返回结果中要提供帮助链接,即API最好做到Hypermedia如果遇到需要跳转的情况 携带调转接口的URL
ret = {
code: 1000,
data:{
id:1,
name:'小强',
depart_id:http://www.luffycity.com/api/v1/depart/8/
}
}