跳至主要內容
SPCX Tools

cURL 轉換器

直接在瀏覽器中將 cURL 指令即時轉換為 JavaScript fetch 或 Python requests 程式碼。

本機執行 — 檔案絕不會離開您的裝置

正在載入工具…

如何使用 cURL 轉換器

  1. 1將您的 cURL 指令貼上至輸入框中。
  2. 2選擇您想要的輸出語言:JavaScript (fetch) 或 Python (requests)。
  3. 3轉換後的程式碼會立即顯示在下方的輸出框中。
  4. 4檢查輸出框下方列出的任何不支援參數,以確保您的請求正確無誤。
  5. 5點擊「複製」將產生的程式碼複製到剪貼簿。

快速且注重隱私的 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 解析工具 可以協助您擷取並編輯特定的查詢參數。

常見問題

什麼是 cURL 轉換器?
cURL 轉換器能將命令列的 curl 請求轉換為 JavaScript 或 Python 等程式語言的等效程式碼。當您需要將在終端機測試過的 API 請求整合到應用程式的程式碼庫時,這能為您節省大量時間。
支援哪些程式語言?
目前,此工具可將 cURL 指令轉換為使用原生 fetch API 的 JavaScript 程式碼,以及使用熱門 requests 函式庫的 Python 程式碼。
我的 API 金鑰或 bearer token 會被傳送到伺服器嗎?
不會。轉換過程完全透過 JavaScript 在您的瀏覽器本地端進行。您的標頭、token 和 payload 資料絕不會被上傳或儲存,確保您的憑證安全無虞。
如果我的 cURL 指令包含不支援的參數會怎樣?
如果解析器遇到目標語言不支援的參數(例如特定的 SSL 憑證或代理伺服器設定),它會將其忽略並產生核心請求。任何被忽略的參數都會列在輸出方塊下方,方便您在需要時手動調整程式碼。
我可以將 cURL 指令轉換為 JavaScript 嗎?
可以,選擇 JavaScript 選項會將您的 cURL 指令轉換為標準的 fetch 請求(包含標頭、方法和 JSON payload),讓您能直接在 Node.js 或瀏覽器環境中使用。
為什麼會出現「無效的 cURL 指令」錯誤?
此工具要求輸入內容必須以 "curl" 開頭。如果您只貼上網址或其他終端機指令,解析器將會拒絕處理。請確保您輸入的是完整且有效的 cURL 指令。