命令列工具 (cURL, HTTPie)

雖然像 Postman 這樣的 GUI 用戶端對使用者很友善，但 命令列介面 (CLI) 仍然是與 API 互動最強大和通用的方式。它允許腳本編寫、自動化以及在沒有 GUI 的伺服器上使用。

1. cURL (Client URL)

官方網站： https://curl.se/

cURL 是 API 工具的鼻祖。它預裝在幾乎每個 Linux/Mac 系統上，是 API 文件的通用語言。

基本語法

範例

GET 請求：

POST JSON：

優點/缺點

✅ 普遍可用（預裝在 99% 的伺服器上）。

✅ 可編寫腳本（bash 腳本、CI/CD）。

❌ 語法冗長。

❌ 難以閱讀：返回沒有顏色或格式的原始文字。

視覺提示：
cURL 輸出通常是一大團白色文字。為了使其可讀，專業人士將其管道傳輸給 jq：
curl ... | jq

2. HTTPie

官方網站： https://httpie.io/

HTTPie 是為「人類」時代設計的現代 CLI HTTP 用戶端。它做的事情與 cURL 相同，但具有簡單、自然的語言語法和彩色輸出。

比較

cURL 方式：

HTTPie 方式：

關鍵功能

隱含 JSON：它假設您想要 JSON。無需手動設定 Content-Type Header。

視覺化輸出：它自動縮排並美化 JSON 並應用 語法高亮（Key 是藍色，String 是綠色，Number 是紫色）。

簡寫：header:value 用於標頭，field=value 用於字串，field:=value 用於原始 JSON。

優點/缺點

✅ 預設提供美麗、人類可讀的輸出。

✅ 打字更少。

❌ 必須安裝 (brew install httpie)，不像原始伺服器上預設可用。

建議

使用 cURL：在分享重現步驟（每個人都有）、編寫 Shell 腳本或在遠端伺服器上除錯時。

使用 HTTPie：用於您自己在終端機中的日常手動測試。它節省打字時間且更易於閱讀。

關鍵要點

cURL 無所不在，對於腳本編寫和分享指令（Copy as cURL）至關重要。

HTTPie (http) 為人類互動帶來了色彩和簡單性。

下一步：在構建之前，您必須設計。讓我們探索 API 設計和文件工具。

命令列工具 (cURL, HTTPie)

1. cURL (Client URL)#

基本語法#

範例#

優點/缺點#

2. HTTPie#

比較#

關鍵功能#

優點/缺點#

建議#

關鍵要點#

1. cURL (Client URL)

基本語法

範例

優點/缺點

2. HTTPie

比較

關鍵功能

優點/缺點

建議

關鍵要點