restful api,设计标准。网络请求(http,https)状态码,为什么使用restful设计标准

本文详细介绍了RESTful API的设计原则,包括使用HTTP动词表示操作、通过URL路径定义资源、版本控制、错误处理等。此外,还讨论了为何RESTful API相对于其他标准更具效率和易用性,并提供了常见的网络请求状态码及其用途。遵循这些规范可提升API的清晰度和可维护性。
摘要由CSDN通过智能技术生成

#1.restful api是什么?

答:restful api 是一种网络api架构,是一种规范。我们可以理解为设计项目时的文件分类。有规范,逻辑清晰。使我们能更好的去开发。
restful api是基于http的一种接口规范,是一种无状态的(http1.1版本之前)。

#2.为什么使用restful api标准(相比其他标准)

答:HTTP协议-URL#
HTTP是一个属于应用层的协议,特点是简捷、快速。

#2.1相比其他标准

效率和易用性#
SOAP由于各种需求不断扩充本身协议的内容,导致在SOAP处理方面的性能有所下降。同时在易用性方面以及学习成本上也有所增加。

RESTful由于其面向资源接口设计以及操作抽象简化了开发者的不良设计,同时也最大限度的利用了Http最初的应用协议设计理念。

安全性#
RESTful对于资源型服务接口来说很合适,同时特别适合对于效
率要求很高,但是对于安全要求不高的场景。

SOAP的成熟性可以给需要提供给多开发语言的, 对于安全性
要求较高的接口设计带来便利。所以觉得纯粹说什么设计模
式将会占据主导地位没有什么意义,关键还是看应用场景。

restful适合做什么开发
接口或者应用

#3.采用restful api 设计一般使用什么样的规范?(参考阮一峰老师的文章)

#3.1协议

API与用户的通信协议,总是使用HTTPs协议。(http也可以,但是建议使用https)

#3.2域名

应该尽量将API部署在专用域名之下。
例如:https://api.example.com
如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下。
例如:https://example.org/api/

#3.3版本(Versioning)

应该将API的版本号放入URL。

例如:https://api.example.com/v1/

另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观。Github采用这种做法。

#3.4路径(Endpoint)

路径又称"终点

  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

南工gjl

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值