Vad gör den?

cURL-till-kod-omvandlaren omvandlar ett curl-kommando till kod som skickar samma HTTP-begäran från ditt eget program. Den skriver tre typer av kod:

  • JavaScript (fetch): fetch-API:t som är inbyggt i webbläsare, Deno, Bun och Node.js.
  • Node.js (Axios): det populära Axios-biblioteket, med Node.js-moduler för filer och TLS-inställningar.
  • Python (Requests): Requests-biblioteket.

Ett vanligt sätt att få fram ett kommando är att använda webbläsarens utvecklarverktyg: högerklicka på en begäran i panelen Nätverk och välj Kopiera som cURL. API-dokumentation visar också ofta exempel som curl-kommandon.

Så använder du verktyget

  1. Klistra in curl-kommandot. Långa kommandon kan sträcka sig över flera rader, med ett omvänt snedstreck i slutet av varje rad, som shell förväntar sig.
  2. Välj språk.
  3. Kopiera koden eller ladda ned den som en fil (request.mjs för JavaScript, request.py för Python).

Koden uppdateras medan du skriver. Om kommandot innehåller ett fel som skulle få curl att misslyckas, till exempel ett oavslutat citattecken eller ett okänt alternativ, pekar verktyget ut det.

Vad konverteras

  • Metoden, inklusive de metoder som curl väljer automatiskt: -d och -F ger en POST, -I en HEAD och -T en PUT.
  • URL:en, inklusive eventuella frågeparametrar som -G eller --url-query lägger till.
  • HTTP-huvuden från -H, användaragenten från -A, referenten från -e och cookies från -b, som blir en cookies-ordbok i Python.
  • Grundläggande autentisering från -u eller från URL:en, med varje biblioteks eget sätt att skicka den, samt Bearer-token från --oauth2-bearer. Python får även Digest-autentisering.
  • Innehåll: JSON från --json eller en JSON Content-Type blir ett objekt eller en ordbok, formulärdata från -d blir URLSearchParams eller en ordbok, och multipart-formulär från -F blir FormData eller en files-ordbok, inklusive filuppladdningar.
  • Tidsgränsen från --max-time (och --connect-timeout i Python), -k för att hoppa över TLS-kontroller, CA- och klientcertifikat samt en proxy från -x.

HTTP-huvuden som curl lägger till automatiskt, till exempel dess egen User-Agent, Accept: */* och Content-Length, utelämnas eftersom biblioteken skickar sina egna. Alternativ som bara ändrar hur curl visar svaret, till exempel -s eller -v, utelämnas också.

När något inte kan konverteras

Vissa saker saknar motsvarighet i ett bibliotek eller språk. De blir kommentarer högst upp i koden, så att ingenting utelämnas i tysthet:

  • Alternativ som saknar motsvarighet, till exempel --retry, listas som ”Konverteras inte”.
  • fetch kan inte hoppa över TLS-kontroller, använda en proxy eller ange en anslutningstidsgräns, och webbläsare låter inte skript ange Cookie-huvudet, även om Node.js gör det.
  • Filer som curl läser, till exempel -d @data.json eller -F photo=@cat.jpg, läses från disk i Node.js och Python. I JavaScript för webbläsare visas de som platshållare som du behöver ersätta, till exempel med en fil från ett <input type="file">.
  • När ett kommando skickar flera begäranden gäller koden den första.

Exempel

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

Så fungerar det

Kommandot läses på samma sätt som ett shell och curl läser det, med citattecken, escape-sekvenser och radfortsättningar, av samma parser som webbplatsens cURL-kommandovaliderare. Därefter skrivs den begäran som curl skulle skicka ut som kod. Allt sker i din webbläsare, så kommandon med token eller lösenord lämnar aldrig din enhet.

Funktioner

  • JavaScript fetch, Node.js Axios och Python Requests
  • HTTP-huvuden, cookies samt grundläggande autentisering och Bearer-autentisering
  • JSON-, formulär-, multipart- och filinnehåll
  • Tidsgränser, TLS-alternativ, certifikat och proxyservrar
  • Kommentarer för sådant som inte kan konverteras
  • Tydliga felmeddelanden för problem i kommandot
  • Kopiera eller ladda ned koden
  • Körs i din webbläsare