写点什么

请不要再管它们叫 REST API 了

  • 2019-12-20
  • 本文字数:988 字

    阅读完需:约 3 分钟

请不要再管它们叫REST API了

2000 年初,Douglas Crockford 宣称 JavaScript 是世界上被误解得最深的一门编程语言。造成误解的主要原因是糟糕的命名方式、设计上的错误和不严格的标准,等等。所以说,导致这种误解是很自然的。


去年,我在推特上发了一条有关 REST 架构范式的推文。



大多数人认为基于 URL 和 HTTP 动词设计的 API 就是 REST API,但这样的想法实际上错得离谱。


这个误解存在了很长一段时间。与 JavaScript 不一样的是,REST 指南已经说得很清楚了,REST 这个名词强调了状态转换(State Transfer),但大多数所谓的 REST API 设计者却忽略了这一点。


如果你问一下身边的程序员他们设计的 API 是否支持 HATEOAS,他们十有八九会瞪大了眼睛看着你,然后说:你到底在说什么?


然而,REST 的名字本身就说明了一切。它并没有说要使用哪一种协议,也没有说使用哪一种方式来标识资源,它只说到表示性状态转移(REpresentational State Transfer)。Roy Fielding 博士说,状态转移管理是 REST API 的一个必要条件。


真正的 REST API 应该为客户端提供状态以及在状态之间进行切换的方式。它提供了资源的表示(不一定是 JSON 格式)和指向相关资源的链接(超链接),这些链接可以让应用程序从一个状态切换到另一个状态。如下例所示:


{  "id": 463219,  "firstName": "John",  "lastName": "Smith",  "company": "Acme Inc.",  "salary": 72500,  "links": [    {      "href": "https://api.myapp.com/employees/employee/463219",      "rel": "self"    },    {      "href": "https://api.myapp.com/companies/company/375",      "rel": "company"    },    {      "href": "https://api.myapp.com/payments/employee/463219",      "rel": "payments"    }    ]}
复制代码


这个例子提供了资源的描述和其他相关资源的信息。


需要特别提到的是,是否使用 HTTP 协议并不重要。REST 的关键之处在于让服务器端来负责客户端的状态转移。客户端的状态几乎是由服务器端来驱动的,所以,讨论 API 版本管理并没有多大意义。客户端只要知道 REST API 的入口点就可以了,剩下的根据服务器端的响应来做决定,但这一点却被大多数人忽略了。


只是简单地将 CRUD 操作映射到 HTTP 动词的 API 与应用程序状态转移丝毫扯不上关系,你可以把它们叫作 Web API 或 HTTP API,但请不要把它们叫作 REST API。

延展阅读

我们为什么从 REST 转向 gRPC

英文原文

Please, Don’t Call Them RESTful


2019-12-20 17:443547
用户头像
小智 让所有人认同的文字称不上表达

发布了 408 篇内容, 共 403.0 次阅读, 收获喜欢 1986 次。

关注

评论

发布
暂无评论
发现更多内容

Android-Q-对-startActivity()-做了限制,怎么适配?,安卓开发自学教程

android 程序员 移动开发

Android 黑科技保活实现原理揭秘,精心整理

android 程序员 移动开发

Android-Apng动画的播放,大牛手把手动态教学,你都不愿意看吗

android 程序员 移动开发

Android-APK瘦身实践:二次瘦身如何再减少大小?,ffmpeg音视频开发实战5

android 程序员 移动开发

Android-Studio-4-0-最新进展,这几个新体验太牛逼了!

android 程序员 移动开发

Android-_巧_仿蚂蚁森林水滴动效,androidstudiojni开发

android 程序员 移动开发

Android 自定义 View 之 LeavesLoading,移动开发工程师考试

android 程序员 移动开发

Android 高频面试必问之Java基础,安卓framework开发

android 程序员 移动开发

Android-冷门知识点汇总:你知道哪些Android中的冷门知识?

android 程序员 移动开发

Android 网络框架之Retrofit源码解析,android嵌入式开发及实训答案

android 程序员 移动开发

Android-10分区存储介绍及百度APP适配实践,三年经验月薪50k我是怎么做到的

android 程序员 移动开发

Android-GC原理探究(深度好文),PDF超过6000页,

android 程序员 移动开发

Android 进阶之 MVP,高级安卓工程师面试题

android 程序员 移动开发

Android-app自动更新总结(已适配9-0),一个回答引发热烈讨论

android 程序员 移动开发

Android 高工面试必考题(二),android开发艺术探索pdf百度云

android 程序员 移动开发

Android&Java面试题大全—金九银十面试必备【上,大厂Android面试真题精选

android 程序员 移动开发

Android-Service-ANR-的监控机制,flutter文档

android 程序员 移动开发

Android-多渠道打包配置;你了解吗?,移动互联网app开发入门

android 程序员 移动开发

Android-怎么就不卡了呢之Choreographer,android开发实例大全

android 程序员 移动开发

Android---用力过猛!为了组件化改造学习十几家大厂的技术博客

android 程序员 移动开发

Android-Q来了!谷歌将在数小时内发布测试版,腾讯+华为+阿里面试真题分享

android 程序员 移动开发

Android 面试官:这些经验要记录好,面试途中会遇到,做了6年的Android

android 程序员 移动开发

Android---Fragment-的过去、现状与未来,android网络层框架设计实战

android 程序员 移动开发

Android 获取子 View 的位置及坐标的方式(1),Android入门视频教程

android 程序员 移动开发

Android 面试主题集合整理,kotlin协程原理

android 程序员 移动开发

Android-ContentProvider实例详解,2021年您应该知道的技术之一

android 程序员 移动开发

Android-Q来了!谷歌将在数小时内发布测试版(1),阿里大牛整理

android 程序员 移动开发

Android-Studio-教程:入门开发第一个程序,2021年最新Android面试点梳理

android 程序员 移动开发

Android-开发必看---Flutter之全埋点思考与实现,你了解过移动端适配吗

android 程序员 移动开发

Android-11-正式发布---开发者们的舞台已就绪,flutterpush消息

android 程序员 移动开发

Android-Binder机制及AIDL使用,字节跳动安卓开发面试题

android 程序员 移动开发

请不要再管它们叫REST API了_架构_Andrea Chiarelli_InfoQ精选文章