📜  状态 201 (1)

📅  最后修改于: 2023-12-03 14:56:13.747000             🧑  作者: Mango

状态 201

状态 201表示成功创建了新的资源,并且服务器已经接受了客户端请求。

HTTP状态码

HTTP状态码是客户端向服务器发出请求时,服务器对该请求的响应的状态指示。在HTTP/1.1中定义了5类状态码。

  • 1XX:信息类状态码,表示服务器接收到请求,需要进一步操作。
  • 2XX:成功类状态码,表示服务器成功接收、理解和处理了请求。
  • 3XX:重定向类状态码,表示服务器需要根据请求来执行进一步的操作。
  • 4XX:客户端错误类状态码,表示客户端提交的请求有误。
  • 5XX:服务器错误类状态码,表示服务器在处理请求过程中发生了错误。

其中,状态码201属于成功类状态码。

返回示例

下面是一个HTTP请求成功返回状态码201的响应头部分示例:

HTTP/1.1 201 Created
Date: Fri, 18 Jun 2021 03:30:10 GMT
Server: Apache/2.2.14 (Win32)
Location: http://www.example.org/index.html
Content-Length: 25
Content-Type: text/html; charset=iso-8859-1

在响应头中,状态码用HTTP/1.1 201 Created表示。服务器也可以在Location响应头中指定新资源的位置。

适用场景
  • 创建新资源:状态码201通常用于在服务器上创建新资源的请求,并将新创建的资源返回给客户端。
  • 异步操作:在进行异步操作时,响应代码202稍后可以被检查。异步操作在客户端发起请求之后通常需要时间来完成,并且需要服务器进行很多处理。
结论

状态码201表示成功创建了新的资源,并且服务器已经接受了客户端请求。在创建新资源时,应该返回状态码201作为响应。此外,为了使API更具有可读性,响应有效载荷可以包含新资源的详细信息。