Hva gjør verktøyet?

cURL-til-kode-konvertereren gjør en curl-kommando om til kode som sender den samme HTTP-forespørselen fra ditt eget program. Den skriver tre typer kode:

  • JavaScript (fetch): fetch-API-et som er innebygd i nettlesere, Deno, Bun og Node.js.
  • Node.js (Axios): det populære Axios-biblioteket, med Node.js-moduler for filer og TLS-innstillinger.
  • Python (Requests): Requests-biblioteket.

En vanlig måte å hente en kommando på er å bruke nettleserens utviklerverktøy: I Nettverk-panelet høyreklikker du på en forespørsel og velger «Kopier som cURL». API-dokumentasjon viser også ofte eksempler som curl-kommandoer.

Slik bruker du verktøyet

  1. Lim inn curl-kommandoen. Lange kommandoer kan gå over flere linjer, med en omvendt skråstrek på slutten av hver linje, slik shell forventer.
  2. Velg språk.
  3. Kopier koden, eller last den ned som en fil (request.mjs for JavaScript, request.py for Python).

Koden oppdateres mens du skriver. Hvis kommandoen inneholder en feil som ville stoppet curl, for eksempel et anførselstegn som ikke er lukket eller et ukjent alternativ, viser verktøyet hvor feilen er.

Dette konverteres

  • Metoden, inkludert metodene curl velger selv: -d og -F gir POST, -I gir HEAD og -T gir PUT.
  • URL-en, inkludert eventuelle spørringsparametere som legges til med -G eller --url-query.
  • Headere fra -H, brukeragenten fra -A, referenten fra -e og cookies fra -b, som blir en cookies-ordbok i Python.
  • Grunnleggende autentisering fra -u eller fra URL-en, med bibliotekets egen måte å sende den på, og Bearer-tokens fra --oauth2-bearer. Python får også Digest-autentisering.
  • Innhold: JSON fra --json eller en JSON Content-Type blir et objekt eller en ordbok, skjemadata fra -d blir URLSearchParams eller en ordbok, og flerdelte skjemaer fra -F blir FormData eller en files-ordbok, inkludert filopplastinger.
  • Tidsavbruddet fra --max-time (og --connect-timeout i Python), -k for å hoppe over TLS-kontroller, CA- og klientsertifikater samt en proxy fra -x.

Headere som curl legger til selv, for eksempel sin egen User-Agent, Accept: */* og Content-Length, utelates, siden bibliotekene sender sine egne. Alternativer som bare endrer hvordan curl viser svaret, som -s eller -v, utelates også.

Når noe ikke kan konverteres

Noen ting har ingen tilsvarende funksjon i et bibliotek eller språk. De blir kommentarer øverst i koden, slik at ingenting utelates uten varsel:

  • Alternativer uten tilsvarende funksjon, som --retry, listes som «Ikke konvertert».
  • fetch kan ikke hoppe over TLS-kontroller, bruke en proxy eller angi et tidsavbrudd for tilkobling. Nettlesere lar heller ikke skript angi Cookie-headeren, selv om Node.js gjør det.
  • Filer curl leser, som -d @data.json eller -F photo=@cat.jpg, leses fra disk i Node.js og Python. I JavaScript i nettleseren vises de som plassholdere du må bytte ut, for eksempel med en fil fra et <input type="file">.
  • Når en kommando sender flere forespørsler, gjelder koden den første.

Eksempler

  • curl https://example.com/ blir til requests.get("https://example.com/") i Python.
  • curl -u ada:secret https://api.example.com/me blir til auth=("ada", "secret") i Python og et auth-alternativ i Axios.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders blir til json={"item": "sourdough loaf"} i Python og JSON.stringify({ item: "sourdough loaf" }) med fetch.

Slik fungerer det

Kommandoen leses slik et shell og curl leser den, med anførselstegn, escape-tegn og linjefortsettelser, av den samme parseren som brukes av nettstedets cURL-kommandovalidator. Deretter skrives forespørselen curl ville ha sendt, ut som kode. Alt skjer i nettleseren din, så kommandoer med tokens eller passord forlater aldri enheten din.

Funksjoner

  • JavaScript fetch, Node.js Axios og Python Requests
  • Headere, cookies, grunnleggende autentisering og Bearer-autentisering
  • JSON, skjemaer, flerdelt innhold og filinnhold
  • Tidsavbrudd, TLS-alternativer, sertifikater og proxyer
  • Kommentarer for alt som ikke kan konverteres
  • Tydelige meldinger om feil i kommandoen
  • Kopier eller last ned koden
  • Kjører i nettleseren din