环球短讯!什么是RESTful API?Restful API接口设计标准
时间:2023-07-05 16:37:47来源:安卓网

什么是RESTful API:

1、RESTful API是REST风格的API,是一套用来规范多种形式的前端和同一个后台的交互方式的协议。RESTful API由后台也就是SERVER来提供前端来调用;前端调用API向后台发起HTTP请求,后台响应请求将处理结果反馈给前端。

2、RESTful API可以用于GET、PUT、POST和DELETE数据类型,这些数据类型与资源相关的操作读取、更新、创建和删除。RESTful API基于表示性状态转移(REST),它是Web服务开发中经常使用的一种体系结构样式和通信方式。

Restful API接口设计标准:

1. 协议

API与用户的通信协议,尽量使用HTTPs协议。

2. 域名

应该尽量将API部署在专用域名之下。

https://api.example.com

如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下。

https://example.org/api/

3. 版本

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

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

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

Github采用这种做法。

4. 路径

路径又称“终点"(endpoint),表示API的具体网址。

在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。一般来说,数据库中的表都是同种记录的“集合"(collection),所以API中的名词也应该使用复数。

举例来说,有一个APl提供动物园(zoo)的信息,还包括各种动物和雇员的信息,则它的路径应该设计成下面这样。

https://api.example.com/v1/zoos

https://api.example.com/v1/animals

https://api.example.com/v1/employees

5. HTTP 动词

对于资源的具体操作类型,由HTTP动词表示。

常用的HTTP动词有下面五个(括号里是对应的SQL命令)。

GET(读取):从服务器取出资源(一项或多项)。

POST(创建):在服务器新建一个资源。

PUT(完整更新):在服务器更新资源(客户端提供改变后的完整资源)。

PATCH(部分更新):在服务器更新资源(客户端提供改变的属性)。

DELETE(删除):从服务器删除资源。

还有两个不常用的HTTP动词。

HEAD:获取资源的元数据。

OPTIONS:获取信息,关于资源的哪些属性是客户端可以改变的。

下面是一些例子。

GET/zoos:列出所有动物园

POST/zoos:新建一个动物园

GET/z00S/ID:获取某个指定动物园的信息

PUT/zoos/ID:更新某个指定动物园的信息(提供该动物园的全部信息)

PATCH/zooS/ID:更新某个指定动物园的信息(提供该动物园的部分信息)

DELETE/zoos/ID:删除某个动物园

GET/zooS/ID/animals:列出某个指定动物园的所有动物

DELETE/zoos/ID/animals/ID:删除某个指定动物园的指定动物

6. 过滤信息

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

下面是一些常见的参数。

?limit=10:指定返回记录的数量

?offset=10:指定返回记录的开始位置。

?page=2&per_page=100:指定第几页,以及每页的记录数。

?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序。

?animal_type_id=1:指定筛选条件

参数的设计允许存在冗余,即允许API路径和URL参数偶尔有重复。

比如,GET/zo0/ID/animals 与 GET/animals?zoo_id=ID的含义是相同的。

7. 状态码

客户端的每一次请求,服务器都必须给出回应。回应包括HTTP状态码和数据两部分。

HTTP状态码就是一个三位数,分成五个类别。

1xx:相关信息

2xx:操作成功。

3xX:重定向

4xx:客户端错误

5xx:服务器错误

标签: 电脑接口规范化操作 数据类型 体系机

最新
  • 环球短讯!什么是RESTful API?Restful API接口设计标准

    什么是RESTful API:1、RESTful API是REST风格的API,是一套用来

  • 二手网站有哪些?珠宝二手交易平台有哪些?_全球播报

    二手网站有哪些?二手网站交易平台主流的就是闲鱼和转转这两家,属于

  • 什么是基金会?基金会和基金公司的区别|天天要闻

    什么是基金会?非营利式基金会是一种非营利式的组织。基金会指的是从

  • 贵州鹏昇(集团)纸业有限责任公司:舞动绿色循环经济轻工业“龙头”_今日看点

    大货车络绎不绝,将废纸运到位于义龙新区新桥镇的贵州鹏昇(集团)纸业

  • 环旭电子涨10.03% 机构净卖出9665万元

    环旭电子涨10 03%机构净卖出9665万元---中国经济网北京7月3日讯环旭电

  • 手机UC浏览器怎么清理缓存? 小米手机浏览器缓存的视频在哪?_全球观速讯

    手机UC浏览器怎么清理缓存?1、打开手机UC浏览器,点击下方菜单图标

  • 红小豆和赤小豆的区别是什么呢?种植赤小豆总的施肥原则是啥?_今日要闻

    红小豆和赤小豆没有区别。红小豆是赤小豆的俗称,除此之外,还称为

  • 失蜡铸造法名词解释_失蜡铸造

    1、模型制作。2、艺术家或模具制造商用蜡、粘土或其他材料创建原始模型

  • 京东白条储蓄卡激活有风险吗?京东白条必须绑定信用卡吗?

    京东白条储蓄卡激活有风险吗?没有。开通京东白条没有风险,但是个人

  • 沿海行20_沿海行相关内容简介介绍

    《沿海行》是央视《远方的家》栏目推出的大型系列特别节目,节目组沿着

  • 当前播报:港股异动 | TCL电子逆势大涨逾10%续刷阶段高价 月内累涨30%

    格隆汇6月29日丨TCL电子(1070 HK)逆势拉升涨超10%,现报4 15港元继续刷

  • 【全球报资讯】开盘:A股三大指数低开沪指跌0.12%,存储芯片概念领涨,减速器概念持续活跃

    金融界6月29日消息今日A股三大指数低开,沪指跌0 12%,报3185 42点,

  • 天天热点!即将建成通车!德余高速乌江特大桥通过荷载试验

    6月28日,德余高速乌江特大桥通过桥梁荷载试验,为后续通车目标奠定坚

  • 当前关注:蚂蚱几条腿?蚂蚱的腿不展开的原因是什么?

    蚂蚱几条腿?蚂蚱六条腿,两条大腿,四条小腿。两条后腿特别长、特别有

  • 二建成绩在哪儿公布

    二建成绩在哪儿公布由二级建造师考试栏目提供,查找更多考试报名资讯、

  • 东莞奇瑞4s店有几家?奇瑞是国产车还是合资车? 当前报道

    东莞奇瑞4s店有几家5家东莞奇瑞汽车4s店主要有5家门店,例如:东莞东

  • 旅游
    • 海豚加速器更换游戏路径教程是什么? 加速器路径怎么设置?-全球新视野

    • 20232023海口港澳通行证办理必须预约吗?_每日热闻

    • 宿豫:擦亮帮办服务品牌 推动营商环境再升级|世界热文

    • 每日消息!dnf移动速度宝珠有哪些?dnf移动速度宝珠大全