写点什么

什么是 Restful 动词

作者:宇宙之一粟
  • 2022 年 7 月 23 日
  • 本文字数:778 字

    阅读完需:约 3 分钟

什么是 Restful 动词

REST 动词指定要对特定资源或资源集合执行的操作。当客户端发出请求时,它应该在 HTTP 请求中发送以下信息:


  • REST 动词

  • 头信息

  • 主体(可选)

REST 使用 URI 来解码其要处理的资源。有很多可用的 REST 动词,但其中有六个是经常使用的。它们如下:

  • GET

  • POST

  • PUT

  • PATCH

  • DELETE

  • OPTIONS

如果您是软件开发人员,那么您大部分时间都会处理这六个问题。下表说明了操作、目标资源以及请求成功或失败时会发生什么:


上表的成功和失败列中的数字是 HTTP 状态代码。每当客户端启动 REST 操作时,休息是无状态的,客户应该知道操作方法是否成功。因此,HTTP 具有响应的状态代码。RET 定义给定操作的前一个状态代码类型。这意味着 REST API 应严格遵循前面的规则来实现客户端 - 服务器通信。


所有定义的 REST 服务都具有以下格式。它由主机和 API 端点组成。 API 端点是服务器预定义的 URL 路径。每个 REST 请求都应该到达该路径。


REST API URI:http://HostName/API endpoint/Query(optional)


让我们更详细地查看所有动词。REST API 设计始于操作的定义和 API 端点。在实现 API 之前,设计文档应列出给定资源的所有端点。在以下部分中,我们仔细观察使用 PayPal 的 REST API 作为用例的 REST API 端点。


GET 方法

GET 方法从服务器获取给定的资源。为了指定一个资源,GET 使用了几种类型的 URI 查询:

  • 查询参数

  • 基于路径的参数

如果您不知道,您对网络的所有浏览都是通过对服务器执行 Get 请求来完成的。例如,如果您键入 www.google.com,则实际上是获取获取搜索页面的 GET 请求。在这里,您的浏览器是客户端,Google 的 Web 服务器是 Web 服务的后端实现者。成功的 Get 操作返回 200 个状态代码。


路径参数的示例:


每个人都知道 PayPal。PayPal 与公司创建结算协议。如果您注册 PayPal 的支付系统,他们为您提供 REST API,以满足您的所有帐单需求。示例获取获取结算协议信息的请求如下所示:

/v1/payments/billing-agreements/agreement_id.


发布于: 2 小时前阅读数: 9
用户头像

宇宙古今无有穷期,一生不过须臾,当思奋争 2020.05.07 加入

🏆InfoQ写作平台-第二季签约作者 🏆 混迹于江湖,江湖却没有我的影子 热爱技术,专注于后端全栈,轻易不换岗 拒绝内卷,工作于软件工程师,弹性不加班 热衷分享,执着于阅读写作,佛系不水文

评论

发布
暂无评论
什么是 Restful 动词_REST API_宇宙之一粟_InfoQ写作社区