A cosa serve?

Il convertitore da cURL a codice trasforma un comando curl in codice che invia la stessa richiesta HTTP dal tuo programma. Genera tre tipi di codice:

  • JavaScript (fetch): l'API fetch integrata nei browser, Deno, Bun e Node.js.
  • Node.js (Axios): la popolare libreria Axios, con moduli Node.js per i file e le impostazioni TLS.
  • Python (Requests): la libreria Requests.

Un modo comune per ottenere un comando è usare gli strumenti per sviluppatori del browser: nel pannello Rete, fai clic con il tasto destro su una richiesta e scegli Copia come cURL. Anche la documentazione delle API mostra spesso esempi sotto forma di comandi curl.

Come si usa

  1. Incolla il comando curl. I comandi lunghi possono estendersi su più righe, con una barra rovesciata alla fine di ogni riga, come previsto dalle shell.
  2. Scegli il linguaggio.
  3. Copia il codice oppure scaricalo come file (request.mjs per JavaScript, request.py per Python).

Il codice si aggiorna mentre scrivi. Se il comando contiene un errore che impedirebbe a curl di funzionare, come una virgoletta non chiusa o un'opzione sconosciuta, lo strumento te lo segnala.

Cosa viene convertito

  • Il metodo, compresi quelli selezionati automaticamente da curl: -d e -F impostano POST, -I imposta HEAD e -T imposta PUT.
  • L'URL, con eventuali parametri di query aggiunti da -G o --url-query.
  • Le intestazioni da -H, l'agente utente da -A, il referrer da -e e i cookies da -b, che in Python diventano un dizionario cookies.
  • L'autenticazione di base da -u o dall'URL, usando il metodo previsto da ciascuna libreria, e i token Bearer da --oauth2-bearer. In Python viene aggiunta anche l'autenticazione Digest.
  • I corpi delle richieste: il JSON da --json o da un Content-Type JSON diventa un oggetto o un dizionario, i dati del modulo da -d diventano URLSearchParams o un dizionario, e i moduli multipart da -F diventano FormData o un dizionario files, inclusi i caricamenti di file.
  • Il timeout da --max-time (e --connect-timeout in Python), -k per ignorare i controlli TLS, i certificati CA e client e un proxy da -x.

Le intestazioni aggiunte automaticamente da curl, come il suo User-Agent, Accept: */* e Content-Length, vengono omesse perché le librerie ne inviano di proprie. Vengono omesse anche le opzioni che modificano solo il modo in cui curl mostra la risposta, come -s o -v.

Quando qualcosa non può essere convertito

Alcuni elementi non hanno un equivalente nella libreria o nel linguaggio. In questi casi diventano commenti all'inizio del codice, così nulla viene omesso senza segnalarlo:

  • Le opzioni senza equivalenti, come --retry, sono elencate come "Non convertite".
  • fetch non può ignorare i controlli TLS, usare un proxy o impostare un timeout di connessione; inoltre, i browser non consentono agli script di impostare l'intestazione Cookie, a differenza di Node.js.
  • I file letti da curl, come -d @data.json o -F photo=@cat.jpg, vengono letti dal disco in Node.js e Python. In JavaScript nel browser sono rappresentati da un segnaposto da sostituire, per esempio con un file proveniente da un <input type="file">.
  • Quando un comando invia più richieste, il codice generato riguarda la prima.

Esempi

  • curl https://example.com/ diventa requests.get("https://example.com/") in Python.
  • curl -u ada:secret https://api.example.com/me diventa auth=("ada", "secret") in Python e un'opzione auth in Axios.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders diventa json={"item": "sourdough loaf"} in Python e JSON.stringify({ item: "sourdough loaf" }) con fetch.

Come funziona

Il comando viene letto come lo leggerebbero una shell e curl, con virgolette, caratteri di escape e continuazioni di riga, usando lo stesso analizzatore del validatore di comandi cURL del sito. La richiesta che curl invierebbe viene quindi generata sotto forma di codice. Tutto avviene nel browser, quindi i comandi con token o password non lasciano mai il tuo dispositivo.

Funzionalità

  • JavaScript fetch, Node.js Axios e Python Requests
  • Intestazioni, cookies, autenticazione Basic e Bearer
  • Corpi JSON, dati di moduli, multipart e file
  • Timeout, opzioni TLS, certificati e proxy
  • Commenti per tutto ciò che non può essere convertito
  • Messaggi chiari per gli errori nel comando
  • Copia o scarica il codice
  • Funziona nel browser