快速且注重隱私的 cURL 轉換器
開發者經常會在 API 文件、教學文章,或在瀏覽器中除錯網路請求時遇到 cURL 指令。手動將這些命令列字串轉換為應用程式碼不僅繁瑣且容易出錯,尤其是在處理複雜的標頭和巢狀 JSON 酬載時更是如此。
這款 curl 轉換器能將此過程自動化,讓您可以立即轉換 curl 指令字串,產生可直接使用的程式碼片段。由於轉換過程完全在您的網頁瀏覽器中進行,您的敏感資料(例如 Bearer token、API 金鑰和私密酬載)絕不會離開您的裝置。您可以安心貼上包含正式環境憑證的指令,完全無需擔心資料外洩或伺服器日誌紀錄的問題。
支援的輸出格式
本工具目前支援將命令列請求轉換為兩種最廣泛使用的程式開發環境:
JavaScript (fetch)
JavaScript 開發者經常需要將 API 範例轉換為前端或 Node.js 程式碼。當您選擇 JavaScript 選項時,本工具會將 cURL 的方法、標頭與資料參數直接對應到標準的 fetch() 呼叫中。這讓 curl 轉 javascript 變成一鍵完成的簡單步驟。它會自動將您的標頭結構化為 JavaScript 物件,並確保 JSON 負載正確格式化為字串化的 body,讓您可以直接貼入 async/await 函式中使用。
Python (requests)
Python 開發者在進行 HTTP 互動時非常依賴 requests 函式庫。本工具會解析 cURL 語法並產生乾淨的 Python 程式碼,自動選擇正確的方法(例如 requests.get 或 requests.post),並將標頭與資料結構化為 Python 字典。將 curl 轉 python requests 可確保您不會遺漏任何細微的標頭設定,也不會弄錯身分驗證 token 的格式。
常見使用情境
串接第三方 API
大多數現代的 API 文件(如 Stripe、Twilio 或 GitHub)主要提供 cURL 格式的程式碼範例。雖然這非常適合在終端機進行快速測試,但你最終還是需要將該請求整合進應用程式中。將文件中的範例貼到這個工具,就能為你的專案程式碼提供完美的起點。
重現瀏覽器請求
在對網頁應用程式進行除錯時,常見的流程是打開瀏覽器的開發者工具,切換到「網路」(Network) 頁籤,在失敗的請求上按右鍵,然後選擇「Copy as cURL」。你可以將該字串直接貼到轉換器中來產生腳本。這對於編寫自動化測試、爬取資料,或在複雜的瀏覽器環境外獨立排除 Bug 非常有幫助。
原型開發與測試
許多開發者習慣先在終端機中建立並測試 HTTP 請求。當 curl 指令回傳預期的 200 OK 回應後,你就可以將它貼到這裡,立即產生等效的 fetch 或 requests 程式碼,確保你的應用程式送出的位元組與終端機測試成功時完全相同。
轉換運作原理
當您貼上輸入內容後,工具會解析字串,並擷取 HTTP 請求的核心元素:
- URL: 請求的目標端點。
- 請求方法 (Method): 從
-X或--request參數擷取(例如 GET、POST、PUT、DELETE)。若未指定,預設為 GET;若有提供資料則預設為 POST。 - 標頭 (Headers): 從每個
-H或--header參數擷取,並彙整為字典或物件。 - 資料 / Payload: 從
-d、--data或--data-raw參數擷取。
雖然本工具能處理絕大多數標準的 API 請求,但 cURL 是一套功能龐大的工具,包含數百種複雜的參數(例如 --compressed、--resolve 或指定的 SSL 憑證路徑)。若解析器遇到無法直接對應至標準 fetch 或 requests 設定的參數,便會專注於核心的 HTTP 請求,並忽略這些特殊參數。
任何被忽略的參數都會清楚列在產生的程式碼下方。這能確保您確切了解哪些部分未被轉換;若您的應用程式碼確實需要這些進階的代理伺服器 (Proxy) 或 SSL 設定,便可手動進行配置。
相關實用工具
處理 API 通常不只是撰寫請求而已。當您使用產生的程式碼成功發出請求後,可能會需要使用 JSON 格式化工具 來格式化回傳的資料,使其更易於閱讀。如果請求失敗,且您需要了解收到的回應碼,請查閱我們的 HTTP 狀態碼 參考指南。最後,如果您需要在轉換前拆解或修改端點 URL,URL 解析工具 可以協助您擷取並編輯特定的查詢參數。