HTTP（Hypertext Transfer Protocol）是Web通信的基礎協議，用于客戶端和服務器之間的請求和響應。本文將詳細介紹HTTP常見的請求方法、響應狀態碼以及接口規范，幫助開發者更好地理解和使用HTTP協議。

一、HTTP請求方法

HTTP請求方法定義了客戶端與服務器之間的交互類型。以下是常見的HTTP請求方法：

1. GET

描述：用于請求指定資源的表示形式。GET請求只應獲取數據，不應對服務器產生任何副作用。

示例：

GET /api/users HTTP/1.1
Host: example.com

2. POST

描述：用于向指定資源提交數據，請求服務器進行處理。通常用于提交表單數據或上傳文件。

示例：

POST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json{"name": "John","email": "john@example.com"
}

3. PUT

描述：用于上傳資源的全部更新。客戶端向服務器發送數據，要求服務器用這些數據替換目標資源的內容。

示例：

PUT /api/users/1 HTTP/1.1
Host: example.com
Content-Type: application/json{"name": "John Doe","email": "john.doe@example.com"
}

4. DELETE

描述：用于刪除指定資源。

示例：

DELETE /api/users/1 HTTP/1.1
Host: example.com

5. PATCH

描述：用于對資源進行部分更新。客戶端發送的請求只包含需要修改的數據。

示例：

PATCH /api/users/1 HTTP/1.1
Host: example.com
Content-Type: application/json{"email": "new.email@example.com"
}

6. HEAD

描述：與GET方法類似，但服務器只返回響應頭部，不返回響應體。用于檢查資源的有效性。

示例：

HEAD /api/users HTTP/1.1
Host: example.com

7. OPTIONS

描述：用于描述目標資源的通信選項。客戶端可以通過此方法了解服務器支持哪些HTTP方法。

示例：

OPTIONS /api/users HTTP/1.1
Host: example.com

二、HTTP響應狀態碼

HTTP響應狀態碼由三位數字組成，用于指示請求是否成功以及需要客戶端采取什么樣的后續行動。以下是常見的HTTP響應狀態碼：

1. 1xx（信息性狀態碼）

• 100 Continue：客戶端應繼續其請求。

2. 2xx（成功狀態碼）

• 200 OK：請求成功，服務器已成功處理請求。
• 201 Created：請求成功并且服務器創建了新的資源。
• 204 No Content：服務器成功處理了請求，但沒有返回任何內容。

3. 3xx（重定向狀態碼）

• 301 Moved Permanently：請求的資源已永久移動到新位置。
• 302 Found：請求的資源臨時移動到新位置。

4. 4xx（客戶端錯誤狀態碼）

• 400 Bad Request：服務器無法理解請求的格式。
• 401 Unauthorized：請求需要用戶認證。
• 403 Forbidden：服務器理解請求，但拒絕執行。
• 404 Not Found：請求的資源不存在。

5. 5xx（服務器錯誤狀態碼）

• 500 Internal Server Error：服務器遇到未知錯誤，無法完成請求。
• 502 Bad Gateway：服務器作為網關或代理，從上游服務器接收到無效響應。
• 503 Service Unavailable：服務器當前無法處理請求。

三、接口規范

接口規范用于定義API的結構和行為，確保客戶端和服務器之間的通信一致性。常見的接口規范包括REST和GraphQL。

1. REST（Representational State Transfer）

REST是一種基于HTTP的架構風格，用于構建Web服務。RESTful API設計原則包括：

• 資源：通過URI（統一資源標識符）表示，如?/api/users。
• HTTP方法：使用HTTP方法定義操作，如GET、POST、PUT、DELETE。
• 狀態碼：使用HTTP狀態碼表示操作結果，如200、201、404。
• 數據格式：通常使用JSON格式進行數據傳輸。

示例：

GET /api/users HTTP/1.1
Host: example.comPOST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json{"name": "John","email": "john@example.com"
}

2. GraphQL

GraphQL是一種用于API的查詢語言，允許客戶端指定請求的數據結構，避免了過多或不足的數據傳輸。

示例：

query {user(id: 1) {nameemail}
}

響應：

{"data": {"user": {"name": "John","email": "john@example.com"}}
}

結論

本文詳細介紹了HTTP常見的請求方法、響應狀態碼和接口規范。