RESTful API 中的状态码一览表

状态码是 RESTful API 中非常重要的一部分,通过状态码来表示服务器返回的响应状态和信息。了解 RESTful API 中的各个状态码及其含义,可以帮助我们更好地理解 API 的使用和开发,也有助于我们处理请求时更加高效和准确。本文将为大家介绍 RESTful API 中的状态码一览表及其含义。

1xx - 信息状态码

1xx 状态码表示服务器已经接收到请求,正在处理中,但尚未完成处理。主要包括以下两种状态码。

  • 100 - Continue:表示服务器已经接收到请求头,客户端可以继续发送请求体。例如,当客户端向服务器提交大文件时,服务器会先检查用户权限等情况,此时服务器返回 100 状态码告知客户端可以继续发送文件内容。
  • 101 - Switching Protocols:表示服务器正在切换协议。例如,当客户端请求从 HTTP 协议切换到 WebSocket 协议时,服务器返回 101 状态码表示正在进行协议切换。

2xx - 成功状态码

2xx 状态码表示服务器已经成功接收、理解并处理了请求。主要包括以下状态码。

  • 200 - OK:表示服务器成功处理了请求。例如,当客户端请求某个资源成功时,服务器会返回 200 状态码,并携带请求结果。
  • 201 - Created:表示服务器成功创建了资源。例如,当客户端使用 POST 方法向服务器提交数据,服务器成功创建新的资源时,返回 201 状态码。
  • 204 - No Content:表示服务器已经成功处理了请求,但是没有返回任何内容。通常使用在 DELETE 或 PUT 请求时。

3xx - 重定向状态码

3xx 状态码表示客户端需要进行进一步的操作才能完成请求。主要包括以下状态码。

  • 301 - Moved Permanently:表示请求的资源已经被永久移动,客户端需要使用新的 URI 进行请求。例如,当客户端请求的资源已经被删除或者迁移时,服务器会返回 301 状态码,同时告知新的 URI。
  • 302 - Found:表示请求的资源被暂时移动,客户端需要使用新的 URI 进行请求。例如,当客户端请求的资源正在维修或者被重新部署时,服务器会返回 302 状态码,同时告知新的 URI。
  • 304 - Not Modified:表示客户端的缓存资源是最新的,可以直接使用。当服务器接收到包含 If-Modified-Since 或 If-None-Match 请求头的请求时,且客户端缓存的资源没有更新时,服务器会返回 304 状态码。

4xx - 客户端错误状态码

4xx 状态码表示客户端请求有错误,常见的状态码有以下类型。

  • 400 - Bad Request:表示客户端请求有语法错误,服务器无法理解。例如,请求参数格式不对、缺失参数等。
  • 401 - Unauthorized:表示客户端请求需要身份验证,但是没有提供凭证。例如,需要登录授权的 API,需要在请求头中携带正确的身份验证数据。
  • 403 - Forbidden:表示客户端请求有权限问题,服务器拒绝请求。例如,客户端请求的资源不允许访问、访问限制等。
  • 404 - Not Found:表示请求的资源不存在,服务器没有找到。例如,客户端请求的 API 地址或资源已删除或未创建等。
  • 405 - Method Not Allowed:表示客户端请求的 HTTP 方法不适用于资源。例如,一个 HTTP POST 请求不适用于只读的 API。
  • 409 - Conflict:表示客户端请求的资源与服务器上的现有资源冲突。例如,上传同名文件或者资源等。
  • 429 - Too Many Requests:表示客户端请求的访问次数超过了 API 的限制。例如,服务器对用户的请求频率进行限制,当客户端请求次数超过限制时,服务器返回此状态码。

5xx - 服务器错误状态码

5xx 状态码表示服务器内部错误,无法完成客户端请求。主要包括以下状态码。

  • 500 - Internal Server Error:表示服务器内部错误,无法完成客户端请求。
  • 503 - Service Unavailable:表示服务器暂时无法提供服务,通常是由于服务器维护或过载等原因,导致服务暂时无法响应请求。

总结

RESTful API 中的状态码是非常重要的一环,它能够准确的描述出客户端请求的返回状态,帮助客户端快速的进行下一步操作。熟悉和掌握 RESTful API 中的状态码,可以帮助我们更好的处理请求并开发更加优秀的 API。下面是一个示例代码,实际中可能还需要在状态码准确之后,按照状态码的含义来对返回信息进行处理,我们可以在完整的业务逻辑中体现。

----------------------------
  -------------- -- -
    -- ---------------- --- ---- -
      ------ ----------------
    - ---- -- ---------------- --- ---- -
      ----- --- -----------------
    - ---- -- ---------------- --- ---- -
      ----- --- --------------
    - ---- -- ---------------- --- ---- -
      ----- --- ---------------------
    - ---- -
      ----- --- --------------------
    -
  --
  ---------- -- -
    ------------------
  --
  ------------ -- -
    -----------------------------
  ---

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/64c32b4a83d39b488171ec53


猜你喜欢

  • Socket.io 和 Vue 结合使用实现即时聊天系统

    在当今的数字时代,即时聊天成为了人们生活中不可或缺的一部分,它能够方便人们随时随地地交流信息。在前端类技术中,Socket.io 和 Vue 结合使用具有极高的可扩展性和可定制性,能够很容易地实现一个...

    1 年前
  • ECMAScript 2017 中的 Object.getOwnPropertyDescriptors:如何使用

    ECMAScript 2017 中的 Object.getOwnPropertyDescriptors:如何使用 ECMAScript 2017 添加了 Object.getOwnPropertyDe...

    1 年前
  • 使用 Headless CMS 构建多平台沉浸式阅读体验

    前言 如今,Web 端不再是唯一的数字媒体传播方式。移动应用和互动电子书的普及使得阅读经历越来越多样化和丰富化。在这篇文章中,我们将探讨如何使用 Headless CMS 构建一个多平台的沉浸式阅读体...

    1 年前
  • 使用 create-react-app 快速构建 React SPA 应用

    前言 React 是一个非常流行的开源 JavaScript 库,主要用于构建用户界面。在 React 中,将界面分解成多个组件,使得代码更容易维护、复用和测试。单页面应用程序(SPA)是一种使用 A...

    1 年前
  • 解决 Material Design 中 EditText 光标颜色不跟随主题变化的问题

    在 Material Design 主题下,Android EditText 的光标颜色默认是蓝色的。然而,当我们改变主题风格时,光标颜色并不会跟随主题变化,导致与主题不搭配,给用户带来困扰。

    1 年前
  • CSS Reset 的设计思路与实现方法

    前言 在网页开发的过程中,我们经常遇到样式的不兼容问题。例如,不同浏览器对于某些属性的默认值不同,在不同设备上显示也会有所差异。解决这些问题有多种方法,其中一种就是使用 CSS Reset。

    1 年前
  • CSS Grid 布局与传统布局的对比

    CSS Grid 布局是一种用于网页布局的新技术,它支持更加灵活和复杂的布局操作,提供了更加优秀的视觉效果,可以极大地提升网页的用户体验。与传统布局相比,CSS Grid 布局具有许多优势。

    1 年前
  • React Redux 如何处理大数据量的展示

    React Redux 是一个基于 React 框架的状态管理工具,它可以帮助开发者更加方便地管理 React 应用的状态并增强应用的性能。然而,当应用需要处理大量的数据时,就需要一些优化手段来提高性...

    1 年前
  • 通过 AR 技术实现市区无障碍导览系统

    身为一个前端开发工程师,我们能够想象到如何通过 AR(增强现实)技术来构建市区无障碍导览系统。 无障碍导览在现代社会中已经很普遍,它是为了方便聋哑人士,视觉障碍者以及行动不便的人而存在的。

    1 年前
  • Babel 编译 react-native 项目时出现”Error: The package @babel/runtime@^7.15.0 does not satisfy its siblings'“怎么办?

    背景 Babel 是一款用于编译 JavaScript 代码的工具,它可以将你写的新版 JavaScript 代码转换成旧版 JavaScript 代码,以支持旧版本的浏览器或 Node.js 等环境...

    1 年前
  • Webpack Encore 学习笔记

    什么是 Webpack Encore? Webpack Encore是一个Web开发工具,它为您提供了使用先进的前端工具构建网站所需的工作流程和配置。Webpack Encore可以用于JavaScr...

    1 年前
  • 如何构建自己的 Web 服务器并启动多个 Node.js 进程

    在开发前端项目的过程中,我们经常会需要搭建自己的 Web 服务器来测试和调试我们的应用程序。而 Node.js 提供了强大的库和工具来构建和启动我们自己的 Web 服务器。

    1 年前
  • ECMAScript 2016: 如何使用函数参数解构?

    ECMAScript 2016: 如何使用函数参数解构? 前言 如果你是一名有经验的 JavaScript 开发者,那么你一定已经听过 ECMAScript 2016(又称 ES7)的函数参数解构特性...

    1 年前
  • PWA 开发常见错误及其修复方法

    PWA(Progressive Web App)是一种新型的 Web 应用程序开发模式,具有类似于原生应用的体验。PWA 应用程序可以被添加到主屏幕,离线时也可以运行。

    1 年前
  • RxJS debounceTime 方法在 Angular 应用中的实际应用

    RxJS debounceTime 方法在 Angular 应用中的实际应用 随着前端应用的复杂性越来越高,我们需要使用更高效的代码来解决问题,以提升用户体验和应用性能。

    1 年前
  • 如何使用 Express.js 实现 GitHub 登录

    GitHub 是全球最大的开源代码托管平台,有数百万的开发者在上面分享代码和协作开发。为了方便开发者登录和授权使用 GitHub,GitHub 提供了 OAuth2.0 授权登录机制,开发者可以使用现...

    1 年前
  • Sequelize 中的数据操作实践及技巧

    Sequelize 是一个 Node.js 中的 ORM(对象关系映射)框架,它能够方便地与多种数据库进行交互,包括 MySQL、PostgreSQL、SQLite 和 Microsoft SQL S...

    1 年前
  • Redis 如何解决由于内存碎片导致的内存溢出问题

    Redis 是一个流行的内存数据结构存储系统,被广泛用于缓存、消息队列、会话存储等应用。内存是 Redis 最重要的资源,但长时间运行后,Redis 可能会遭受内存碎片(Memory Fragment...

    1 年前
  • 如何使用 gulp 和 ESLint 来自动化代码格式化

    前端开发的过程中,一个人写代码生产效率是高的,但是在团队中,要想保持代码的规范性,必须对代码进行格式化。而代码格式化的过程往往需要花费开发者很多时间和精力,因此,我们需要使用自动化工具来降低这种负担。

    1 年前
  • 通过 Web Components 实现前端集成开发

    在现代的前端开发中,一个项目可能会包含多个模块或组件,而这些模块或组件往往需要实现相似的功能,如表格、弹框、轮播图等。如果每个模块或组件都是独立开发、独立维护的,对于开发效率和代码复用率都是很不利的。

    1 年前

相关推荐

    暂无文章