后台服务之RESTful API

简介: 后台服务之RESTful API

程序员说的 REST 并不是我们理解的英语单词“REST”,它是 Representational State Transfer的缩写,意为“表现层状态转化”。REST是一种定义API的风格。


我们在之前的章节曾经介绍过API,它是一些能力的集合。比如程序员老王写了一个“把大象装进冰箱”的API,如果程序员小明在实现产品经理的需求时,也需要把大象装进冰箱,他就可以直接调用程序员老王提供的API,不用再费时费力做一遍“把大象装冰箱”的逻辑。API 有很多种,如果我们的项目里用到别人提供的 SDK,就要用SDK里定义好的API。放到REST这里,则指的是网站的后台给前端提供的API到底是一种什么样的风格。

我们举个例子。做后台开发的程序员老王实现了一套好友管理系统,可以为当前用户添加、删除好友,也可以查询用户的所有好友。他写了一套API,包含add_friends、delete_friends和get_friends三个功能。前端人员想要调用他的API,只需要访问不同的URL。比如想要添加好友,可以用http://api.laowang.com/add_friends.php这个URL,其他API依此类推。


假如用户单击了查看好友列表的按钮,前端就会访问

http://api.laowang.com/get_friends.php,后台收到之后,知道前端想调用“查询好友”的 API,就会把所有好友的数据返回给前端。这是一种“简单粗暴”的 API 设计风格。后台针对添加、删除和查询好友设计了三个URL,然后根据前端访问的URL来判断其目的。人们一开始发明HTTP、使用URL的时候就想到了根据URL来区分API,这么做的后果自然是URL越来越长,到后面前端也不知道自己在用什么URL了。直到有一天,有人提出了REST的设计风格,才使得整个API的设计充满了美感。


REST 风格是如何满足老王的需求的呢?首先,它规定 URL 只能表示资源。也就是说,REST 是面向资源的,服务器上有什么东西,都会通过 URL 暴露出来。在这个例子里,服务器上有一个好友列表,那它对应的 URL 就是 http://api.laowang.com/friends。无论是添加、删除还是查询,只要是针对好友列表的操作,都只能用这个URL。


那么,后台如何区分前端到底是想添加好友、删除好友还是查询好友?很简单,交给HTTP去做。HTTP原生支持4个动词,分别是GET、POST、PUT和DELETE(如表5-5所示)。平时我们浏览网页的时候,浏览器会用GET动词去服务器上拉取资源,这个操作也可以理解为查询。当我们要登录某个网站的时候,我们填写的账号、密码之类的信息会通过POST请求上传到服务器。PUT和DELETE很少有用武之地。


2466108-2534689addf0b23b.webp.jpg


针对好友列表的一系列操作,可以分别用HTTP的4个动词发起请求。比如删除一个好友,就是用DELETE访问http://api.laowang.com/friends。尽管服务器收到请求的URL都相同,但是它可以根据请求来的动词区分前端到底想调用哪个API,这便是REST的精髓所在。它把访问服务器的过程看作操作数据库。数据库里的资源可以根据表名来定位,服务器上的资源也可以用URL定位。我们对数据库的操作主要是CRUD(增查改删),利用REST,我们也可以对后台资源进行CRUD。


摘自《给产品经理讲技术》


目录
相关文章
|
3天前
|
JSON 缓存 JavaScript
深入浅出:使用Node.js构建RESTful API
在这个数字时代,API已成为软件开发的基石之一。本文旨在引导初学者通过Node.js和Express框架快速搭建一个功能完备的RESTful API。我们将从零开始,逐步深入,不仅涉及代码编写,还包括设计原则、最佳实践及调试技巧。无论你是初探后端开发,还是希望扩展你的技术栈,这篇文章都将是你的理想指南。
|
6天前
|
存储 API 数据库
使用Python和Flask构建简单的RESTful API
使用Python和Flask构建简单的RESTful API
|
6天前
|
JSON 关系型数据库 测试技术
使用Python和Flask构建RESTful API服务
使用Python和Flask构建RESTful API服务
|
14天前
|
SQL 缓存 测试技术
构建高性能RESTful API:最佳实践与避坑指南###
—— 本文深入探讨了构建高性能RESTful API的关键技术要点,从设计原则、状态码使用、版本控制到安全性考虑,旨在为开发者提供一套全面的最佳实践框架。通过避免常见的设计陷阱,本文将指导你如何优化API性能,提升用户体验,确保系统的稳定性和可扩展性。 ###
52 12
|
11天前
|
JSON JavaScript API
深入浅出Node.js:从零开始构建RESTful API
【10月更文挑战第39天】 在数字化时代的浪潮中,API(应用程序编程接口)已成为连接不同软件应用的桥梁。本文将带领读者从零基础出发,逐步深入Node.js的世界,最终实现一个功能完备的RESTful API。通过实践,我们将探索如何利用Node.js的异步特性和强大的生态系统来构建高效、可扩展的服务。准备好迎接代码和概念的碰撞,一起解锁后端开发的新篇章。
|
14天前
|
存储 API 开发者
深入理解RESTful API设计原则
本文探讨了RESTful API的设计原则,强调了其在现代Web服务中的重要性。通过分析状态表示转移(REST)的概念、核心约束以及最佳实践,本文旨在为开发者提供构建高效、可扩展和易于维护的API的指导。文章还讨论了常见的设计陷阱和如何避免它们,以确保API设计的健壮性和灵活性。
|
16天前
|
JSON 缓存 API
构建高效RESTful API的最佳实践
【10月更文挑战第34天】在数字时代的浪潮中,后端开发扮演着至关重要的角色。本文将带你深入探索如何构建高效的RESTful API,从设计原则到实际编码技巧,再到性能优化和错误处理,我们将一一解锁这些技能。你将学会如何打造一个既优雅又强大的后端服务,让你的应用程序在激烈的市场竞争中脱颖而出。那么,让我们一起踏上这段精彩的旅程吧!
28 2
|
17天前
|
XML JSON API
【PHP开发专栏】PHP RESTful API设计与开发
随着互联网技术的发展,前后端分离成为Web开发的主流模式。本文介绍RESTful API的基本概念、设计原则及在PHP中的实现方法。RESTful API是一种轻量级、无状态的接口设计风格,通过HTTP方法(GET、POST、PUT、DELETE)操作资源,使用JSON或XML格式传输数据。在PHP中,通过定义路由、创建控制器、处理HTTP请求和响应等步骤实现RESTful API,并强调了安全性的重要性。
22 2
|
1天前
|
JSON API 开发者
深入理解RESTful API设计原则
在数字化时代,API已成为连接不同软件应用的桥梁。本文旨在探讨RESTful API设计的基本原则和最佳实践,帮助开发者构建高效、可扩展的网络服务接口。通过解析REST架构风格的核心概念,我们将了解如何设计易于理解和使用的API,同时保证其性能和安全性。
|
1天前
|
安全 测试技术 API
构建高效RESTful API:后端开发的艺术与实践####
在现代软件开发的浩瀚星空中,RESTful API如同一座桥梁,连接着前端世界的绚丽多彩与后端逻辑的深邃复杂。本文旨在探讨如何精心打造一款既高效又易于维护的RESTful API,通过深入浅出的方式,剖析其设计原则、实现技巧及最佳实践,为后端开发者提供一份实用的指南。我们不深入晦涩的理论,只聚焦于那些能够即刻提升API品质与开发效率的关键点,让你的API在众多服务中脱颖而出。 ####
8 0