HTTP 状态码说明 📊

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success",
  "data": {
    "id": 123,
    "name": "小明"
  }
}

HTTP/1.1 201 Created
Location: /api/users/456
Content-Type: application/json

{
  "status": "success",
  "data": {
    "id": 456,
    "name": "新用户"
  }
}

HTTP/1.1 204 No Content

HTTP/1.1 301 Moved Permanently
Location: https://new-api.example.com/users

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "请求参数验证失败",
    "details": [
      {
        "field": "email",
        "message": "邮箱格式不正确"
      }
    ]
  }
}

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer
Content-Type: application/json

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "需要认证"
  }
}

HTTP/1.1 403 Forbidden
Content-Type: application/json

{
  "error": {
    "code": "FORBIDDEN",
    "message": "没有访问权限"
  }
}

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "NOT_FOUND",
    "message": "用户不存在"
  }
}

HTTP/1.1 409 Conflict
Content-Type: application/json

{
  "error": {
    "code": "CONFLICT",
    "message": "邮箱已被注册"
  }
}

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "服务器内部错误"
  }
}

HTTP/1.1 503 Service Unavailable
Retry-After: 3600
Content-Type: application/json

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "服务维护中，请稍后重试"
  }
}

{
  "error": {
    "code": "ERROR_CODE",
    "message": "错误描述",
    "details": [
      {
        "field": "字段名",
        "message": "具体错误信息"
      }
    ]
  }
}