服务器响应 201 Created
HTTP 状态码 201 的含义
HTTP 状态码 201（Created）表示成功创建了一个资源。这个状态码通常在执行导致服务器上新对象创建的操作时使用。
定义与使用
状态码 201 表示请求已经成功处理，并且服务器已经创建了一个新的资源。这个响应通常伴随着一个指向新创建资源的 URI，便于客户端进一步操作。
API 中的应用背景
在 API 的上下文中，状态码 201 经常在 POST 请求的成功响应中使用。它指示客户端请求的数据已成功接收并处理，且新的资源已被创建。
实际使用 201 代码的示例
- 成功创建用户的示例: 当用户在注册时发送 POST 请求，服务器处理请求后返回状态码 201，表明用户已成功创建。
- 创建新博客文章的示例: 用户提交新文章的内容，服务器返回状态码 201，指示文章已被成功添加到数据库。
- 在电子商务网站上添加商品的示例: 商家通过 API 提交新商品信息，成功后服务器返回状态码 201，确认商品已被添加。
201 代码错误处理
创建资源时可能出现的原因
- 请求数据不完整或格式不正确
- 服务器内部错误或数据库问题
- 权限不足，用户未被授权创建该资源
如何正确处理 201 响应
当接收到状态码 201 时，客户端应当检查响应体中的数据，通常包括新资源的详细信息和其 URI。
在不同编程语言中处理创建资源的问题
Python 示例（使用 requests 库）
- 导入 requests 库。
- 构建 POST 请求并发送数据。
- 检查响应状态码是否为 201，并处理返回的数据。
JavaScript 示例（使用 fetch API）
- 使用 fetch 函数发送 POST 请求。
- 处理响应，检查状态码是否为 201。
- 解析响应体中的数据，执行后续操作。
PHP 示例（使用 cURL）
- 初始化 cURL 会话。
- 设置请求的 URL 和数据。
- 执行请求并获取响应状态码，处理返回结果。
处理成功的 201 响应
如何解读返回的数据
在收到状态码 201 后，客户端应关注响应体中返回的资源信息，以便进行后续操作，如更新 UI 或存储数据。
创建后如何使用返回的资源
客户端可以使用返回的 URI 进行进一步的操作，例如获取新资源的详细信息或执行更新请求。
处理状态码 201 的建议
- 遵循 API 的最佳实践，确保请求数据的格式和完整性。
- 在测试创建资源时，确保检查所有可能的响应，特别是状态码和返回数据的准确性。
| 状态码 | 说明 | 常见场景 |
|---|---|---|
| 201 | 资源成功创建 | 用户注册、添加文章、上架商品 |
| 400 | 请求错误 | 数据格式错误、缺少必要字段 |
| 500 | 服务器内部错误 | 数据库连接失败、处理请求时出错 |
通过上述信息，可以更好地理解和有效地利用 HTTP 状态码 201。它不仅告诉我们请求的结果，还为我们提供了进一步操作的基础。