简单认识RESTful API

RESTful API是一种遵循REST原则的接口设计规范,用于高效、可读且可扩展的分布式系统。它通过HTTP动词(GET、POST、PUT、DELETE)操作资源,如SELECT、CREATE、UPDATE和DELETE。URI不应包含动词,而是用名词表示资源。设计时考虑版本控制、信息过滤等。RESTful API统一了不同设备与后端的通信方式,提高了交互的标准化。
摘要由CSDN通过智能技术生成

(What)什么是RESTful API

具象状态传输(REST,Representational State Transfer) 是一组实现效率、可读性、还有可拓展分散式系统的软件架构设计规范。如果一个系统能坚守这些规范,那么它就是 RESTful。

说句简单点的话,RESTful API就是符合REST规范,即REST风格的API,那…那REST规范又是虾米(O_o)??

HTTP动词

对于资源的具体操作类型:

对应SQL的命令含义
GETSELECT从服务器取出资源
POSTCREATE从服务器新建一个资源
PUTUPDATE从服务器更新资源
DELETEDELETE从服务器删除资源

URI

网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。

区分URI和URL
答:
URI(Uniform Resource Indentifier)指统一资源标识符,表示某一互联网资源。
URL(Uniform Resource Locator)指统一资源定位符,资源的地址,是URI的子集。
举个栗子吧(╹▽╹) URI:http://www.123.com/123/ | URL:http://www.123.com/123/index.html

版本

将版本号放入:https://api.example.com/v1

过滤信息

如果记录数量很多,服务器不可能都将它们返回给用户。API应该提供参数,过滤返回结果。

  • ?limit=10:指定返回记录的数量
  • ?offset=10:指定返回记录的开始位置。
  • ?page=2&per_page=100:指定第几页,以及每页的记录数。
  • ?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序。
  • ?animal_type_id=1:指定筛选条件

(Why)为什么使用RESTful API

  • 统一的机制,方便不同的前端设备与后端进行通信;
  • 一套协议规范多种形式的前端和同一个后台的交互方式。

(How)RESTful API设计

RESTful API URI 设计的一些总结

HTTP状态码

在这里插入图片描述
另附:在博客园RESTful API URI 设计: 判断资源是否存在?看到的一张 HTTP status code 示意图

参考资料

REST - 术语表 | MDN
RESTful API 设计指南
什么是RESTful API?
《图解HTTP》

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值