想象一下，你需要在 CI/CD 流水線里發(fā)送一些 API 調(diào)用惧磺，以進(jìn)行身份驗(yàn)證颖对、獲取數(shù)據(jù)、發(fā)送簡(jiǎn)單請(qǐng)求或從網(wǎng)絡(luò) URI 下載文件磨隘。
你會(huì)選擇哪些工具缤底？
答案可能是使用像 Postman 這樣的著名 API 測(cè)試工具顾患。
不過(guò)一般情況下只需要用 curl 就夠了。而且很多年之前 curl 就已經(jīng)跨平臺(tái)了个唧，我記得 windows 上也是可以使用的江解。
所以我認(rèn)為，寫(xiě)一篇關(guān)于 CURL 的文章是值得的徙歼。
我將這篇文章的范圍縮小到 HTTP/HTTPS犁河，因?yàn)閷?xiě)一篇關(guān)于 curl 全部功能的文章會(huì)花費(fèi)好幾天。你很快就會(huì)明白我為什么這么說(shuō)魄梯。
curl 是做什么的呼股？
Curl，全稱(chēng)為“Client URL”画恰，是一種命令行工具彭谁，用于通過(guò) URL 傳輸數(shù)據(jù)。curl 還用于汽車(chē)允扇、電視機(jī)缠局、路由器、打印機(jī)考润、音頻設(shè)備狭园、手機(jī)、平板電腦糊治、醫(yī)療設(shè)備唱矛、機(jī)頂盒、電腦游戲井辜、媒體播放器等绎谦。
Curl 是超過(guò)二百億個(gè)軟件應(yīng)用程序中的互聯(lián)網(wǎng)傳輸引擎。
幾乎每個(gè)使用互聯(lián)網(wǎng)的人每天都會(huì)使用 Curl粥脚。
你能想象它支持多少協(xié)議嗎窃肠？
DICT、FILE刷允、FTP冤留、FTPS、GOPHER树灶、GOPHERS纤怒、HTTP、HTTPS天通、IMAP泊窘、IMAPS、LDAP、LDAPS州既、MQTT谜洽、POP3萝映、POP3S吴叶、RTMP、RTMPS序臂、RTSP蚌卤、SCP、SFTP奥秆、SMB逊彭、SMBS、SMTP构订、SMTPS侮叮、TELNET、TFTP悼瘾、WS 和 WSS囊榜。curl 支持 TLS 證書(shū)、HTTP POST亥宿、HTTP PUT卸勺、FTP 上傳、基于 HTTP 表單的上傳烫扼、代理（SOCKS4曙求、SOCKS5、HTTP 和 HTTPS）映企、HTTP/2悟狱、HTTP/3、cookie堰氓、用戶(hù)+密碼認(rèn)證（Basic芽淡、Plain、Digest豆赏、CRAM-MD5挣菲、SCRAM-SHA、NTLM掷邦、Negotiate白胀、Kerberos、Bearer tokens 和 AWS Sigv4）抚岗、文件傳輸恢復(fù)或杠、代理隧道、HSTS宣蔚、Alt-Svc向抢、unix 域套接字认境、HTTP 壓縮（gzip、brotli 和 zstd）挟鸠、etags叉信、并行傳輸、DNS-over-HTTPS艘希，等等硼身。
為什么選擇 Curl？因?yàn)樗?jiǎn)單覆享、無(wú)處不在且靈活佳遂！
簡(jiǎn)單易用：Curl 就像 API 測(cè)試的瑞士軍刀。它簡(jiǎn)單撒顿、直接丑罪，不需要編程博士學(xué)位就能使用。只需輸入幾個(gè)命令凤壁，按下回車(chē)鍵吩屹，瞧，你就像專(zhuān)業(yè)人士一樣發(fā)送或測(cè)試 API客扎！
隨處可用：無(wú)論你是在 Mac祟峦、PC 還是 Linux 機(jī)器上，Curl 都能為你服務(wù)徙鱼。不需要為不同平臺(tái)使用不同的工具宅楞，Curl 與每個(gè)人都相處得很好。
讓我們開(kāi)始發(fā)送 API 請(qǐng)求吧
首先確保你已經(jīng)在電腦上安裝了 Curl袱吆。別擔(dān)心厌衙，這就像下載一個(gè)應(yīng)用程序或使用包管理器一樣簡(jiǎn)單。安裝完成后绞绒，你就準(zhǔn)備好了婶希！
你可以從官方網(wǎng)頁(yè)下載并安裝 Curl，或者使用像 Homebrew（適用于 macOS 和 Linux）或 Chocolatey（適用于 Windows）這樣的包管理器蓬衡。
發(fā)送你的第一個(gè)請(qǐng)求
想象一下你想從一個(gè) API 獲取員工列表喻杈。使用 Curl 是這樣的：
curl https://dummy.restapiexample.com/api/v1/employees
按下回車(chē)鍵，Curl 就會(huì)為你獲取用戶(hù)數(shù)據(jù)狰晚。就是這么簡(jiǎn)單筒饰！
輸出
{
"status": "success",
"data": [
{
"id": 1,
"employee_name": "Tiger Nixon",
"employee_salary": 320800,
"employee_age": 61,
"profile_image": ""
},
...
],
"message": "Successfully! All records has been fetched."
}
CURL 選項(xiàng)
在我們開(kāi)始示例之前，先了解一下 CURL 中一些最有用的選項(xiàng)壁晒。這里是一些常用的選項(xiàng)：
-H瓷们，--header：允許你在請(qǐng)求中包含自定義 HTTP 頭。例如：
curl -H "Content-Type: application/json" https://api.example.com/resource
-d，--data：在請(qǐng)求體中發(fā)送數(shù)據(jù)谬晕。適用于 POST 和 PUT 請(qǐng)求碘裕。例如：
curl -X POST -d '{"name": "John"}' https://api.example.com/users
-i，--include：在輸出中包含 HTTP 響應(yīng)頭攒钳。例如：
curl -i https://api.example.com/resource
-o帮孔，--output：將響應(yīng)體寫(xiě)入文件而不是打印到 stdout。例如：
curl -o response.txt https://api.example.com/resource
-u夕玩，--user：提供 HTTP 基本認(rèn)證的憑證（用戶(hù)名:密碼）你弦。例如：
curl -u username:password https://api.example.com/resource
-F惊豺，--form：以 multipart/form-data 請(qǐng)求發(fā)送數(shù)據(jù)燎孟。適用于上傳文件。例如：
curl -F "file=@example.txt" https://api.example.com/upload
-X尸昧，--request：指定 HTTP 請(qǐng)求方法（GET揩页、POST、PUT烹俗、DELETE 等）爆侣。例如：
curl -X POST https://api.example.com/resource
-v，--verbose：顯示關(guān)于請(qǐng)求和響應(yīng)的詳細(xì)信息幢妄，包括頭和狀態(tài)碼。例如：
curl -v https://api.example.com/resource
你還可以組合這些選項(xiàng)。你會(huì)在下面看到更多的例子陷嘴。
CURL CRUD 操作
Curl 支持各種 HTTP 方法尉剩，包括 GET、POST潮尝、PUT榕吼、PATCH 和 DELETE，允許你對(duì) API 資源執(zhí)行 CRUD（創(chuàng)建勉失、讀取羹蚣、更新、刪除）操作乱凿。以下是每個(gè) CRUD 操作的 Curl 命令示例：
POST（創(chuàng)建）
在下面的示例中顽素，“curl -X POST” 表示 HTTP 請(qǐng)求應(yīng)該是 POST 請(qǐng)求。你可以根據(jù)要發(fā)送的請(qǐng)求類(lèi)型將“POST”替換為其他 HTTP 方法徒蟆，如 GET胁出、PUT、DELETE 等后专。
curl -X POST -H "Content-Type: application/json" -d '{"name":"Chamila","salary":"1000","age":"40"}' https://dummy.restapiexample.com/api/v1/create
輸出
{
"status": "success",
"data": {
"id": 1960
},
"message": "Successfully! Record has been added."
}
GET（讀然搿）
GET 是默認(rèn)的 CURL 命令。所以你不需要指定任何選項(xiàng)。
curl https://dummy.restapiexample.com/api/v1/employee/1
輸出
{
"status": "success",
"data": {
"id": 1,
"employee_name": "Tiger Nixon",
"employee_salary": 320800,
"employee_age": 61,
"profile_image": ""
},
"message": "Successfully! Record has been fetched."
}
PUT（更新）
curl -X PUT -H "Content-Type: application/json" -d '{"name":"Chamila A","salary":"2000","age":"40"}' https://dummy.restapiexample.com/public/api/v1/update/2
輸出
{
"status": "success",
"data": [],
"message": "Successfully! Record has been updated."
}
DELETE（刪除）
curl -X DELETE https://dummy.restapiexample.com/api/v1/delete/2
輸出
{
"status": "success",
"data": "2",
"message": "Successfully! Record has been deleted"
}
高級(jí)選項(xiàng)
有時(shí)裸诽，你需要證明自己的身份或在請(qǐng)求中添加特殊指令嫂用。別擔(dān)心，Curl 也能幫你搞定丈冬！
添加認(rèn)證：
curl -H "Authorization: Bearer <token>" https://api.example.com/protected/resource
自定義頭：
curl -H "X-Custom-Header: Value" https://api.example.com/users
Curl 就像變色龍——它可以適應(yīng)任何情況嘱函！
處理響應(yīng)
發(fā)送請(qǐng)求后，你會(huì)從 API 那里得到響應(yīng)埂蕊。Curl 可以幫你理解這一切往弓！
檢查響應(yīng)頭：
curl -i https://dummy.restapiexample.com/api/v1/employee/1
輸出
HTTP/1.1 200 OK
Date: Mon, 13 May 2024 21:58:33 GMT
Server: nginx/1.21.6
Content-Type: application/json
Cache-Control: no-cache, private
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
Cache-Control: max-age=86400
Expires: Tue, 14 May
2024 21:58:33 GMT
Vary: Accept-Encoding
X-Endurance-Cache-Level: 2
X-nginx-cache: WordPress
X-Server-Cache: true
X-Proxy-Cache: MISS
Transfer-Encoding: chunked
{"status":"success","data":{"id":1,"employee_name":"Tiger Nixon","employee_salary":320800,"employee_age":61,"profile_image":""},"message":"Successfully! Record has been fetched."}
將響應(yīng)數(shù)據(jù)保存到文件：
curl -o response.json https://dummy.restapiexample.com/api/v1/employee/1
格式化 JSON 響應(yīng)：
你需要安裝 jq。你可以使用 brew 或 choco 來(lái)安裝它蓄氧。
在 Windows 中
choco install jq
安裝完成后函似，你可以運(yùn)行
curl https://dummy.restapiexample.com/api/v1/employee/1 | jq
輸出
{
"status": "success",
"data": {
"id": 1,
"employee_name": "Tiger Nixon",
"employee_salary": 320800,
"employee_age": 61,
"profile_image": ""
},
"message": "Successfully! Record has been fetched."
}
沒(méi)有 jq 的輸出將會(huì)是這樣的
{
"status": "success",
"data": {
"id": 1,
"employee_name": "Tiger Nixon",
"employee_salary": 320800,
"employee_age": 61,
"profile_image": ""
},
"message": "Successfully! Record has been fetched."
}
