软件开发中常说的RESTful风格API究竟是什么

超、凢脫俗 2022-02-12 13:51 98阅读 0赞

# 软件开发中常说的RESTful风格API究竟是什么？ #

软件编程指南 2018-07-03 06:44:00

**一说到REST，我想大家的第一反应就是“啊，就是那种前后台通信方式。”但是在要求详细讲述它所提出的各个约束，以及如何开始搭建REST服务时，却很少有人能够清晰地说出它到底是什么，需要遵守什么样的准则。在您将看到的这一篇文章中，我们将对REST，尤其是基于HTTP的REST服务进行详细地介绍。通过这些文章，您不仅可以了解到什么是REST，更能清晰地了解到您在编写REST服务时所需要遵守的各个守则，设计RESTful API时需要考虑的各种因素以及实现过程中可能遇到的问题等内容。**

# **目录** #

1.  Rest关键词解释
2.  REST概念
3.  REST遇到的问题及示例
4.  总结

# 一. Rest关键词解释 #

1.  **REST(Representational State Transfer)：表述性状态转移**
2.  **Rest是web服务的一种架构风格,一种轻量级,跨平台,跨语言的架构设计;**

# 二. Rest概念 #

在RESTful架构中，每个网址代表一种资源（resource），所有网址请求接口中不能有动词，只能有名词,这点和数据库设计风格很像。

**那么可能有同学会问了？动词怎么来表示呢？**

常用的HTTP动词有五个,对应sql中命令。也就是说我们定义接口url中一般不会出现动词，都是使用名词,而动词使用HTTP请求方式来表示。

*  GET（SELECT）：从服务器取出资源（一项或多项）。
 *  POST（CREATE）：在服务器新建一个资源。
 *  PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
 *  PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。
 *  DELETE（DELETE）：从服务器删除资源。

![img\_0d4c31f480cec51d889dd297644bc8af.jpe][img_0d4c31f480cec51d889dd297644bc8af.jpe]

软件开发中常说的RESTful风格API究竟是什么？

![img\_63c3370357ec67c9e73238faa65c98df.jpe][img_63c3370357ec67c9e73238faa65c98df.jpe]

软件开发中常说的RESTful风格API究竟是什么？

# 三. REST遇到的问题 #

**复数形式怎么表示？**

*  [https://api.example.com/v1/zoos][https_api.example.com_v1_zoos]
 *  [https://api.example.com/v1/animals][https_api.example.com_v1_animals]
 *  [https://api.example.com/v1/employees][https_api.example.com_v1_employees]

**版本怎么表示(演示中我们参考github的风格)？**

其实一般互联网技术类公司都有自己的风格,这个参考就好

*  [https://developer.github.com/v3/media/\#request-specific-version][https_developer.github.com_v3_media_request-specific-version] (**Github采用这种做法**)

**例子**

*  GET /zoos：列出所有动物园
 *  POST /zoos：新建一个动物园
 *  GET /zoos/ID：获取某个指定动物园的信息
 *  PUT /zoos/ID：更新某个指定动物园的信息（提供该动物园的全部信息）
 *  PATCH /zoos/ID：更新某个指定动物园的信息（提供该动物园的部分信息）
 *  DELETE /zoos/ID：删除某个动物园
 *  GET /zoos/ID/animals：列出某个指定动物园的所有动物
 *  DELETE /zoos/ID/animals/ID：删除某个指定动物园的指定动物

# 总结 #

当你看到这里，这边文章已经讲完了，相信你已经，对什么是Restful风格已经有一个自己的概念。但是小编还是要强调一点的是。请务必记住: REST是一种跨平台、跨语言的架构风格。而不是已经技术。所以对于刚入行的开发者,请千万不要害怕。其实就这么简单。

[img_0d4c31f480cec51d889dd297644bc8af.jpe]: /images/20220212/af781893d2be4f99b8eb59a68d352bec.png
[img_63c3370357ec67c9e73238faa65c98df.jpe]: /images/20220212/0d3187de59d44104aa244de44cee08ef.png
[https_api.example.com_v1_zoos]: https://api.example.com/v1/zoos
[https_api.example.com_v1_animals]: https://api.example.com/v1/animals
[https_api.example.com_v1_employees]: https://api.example.com/v1/employees
[https_developer.github.com_v3_media_request-specific-version]: https://developer.github.com/v3/media/#request-specific-version