Wat doet het?

De cURL-naar-codeconverter zet een curl-opdracht om in code die vanuit je eigen programma hetzelfde HTTP-verzoek verstuurt. De tool genereert drie soorten code:

  • JavaScript (fetch): de fetch-API die is ingebouwd in browsers, Deno, Bun en Node.js.
  • Node.js (Axios): de populaire Axios-bibliotheek, met Node.js-modules voor bestanden en TLS-instellingen.
  • Python (Requests): de Requests-bibliotheek.

Een veelgebruikte manier om een opdracht te verkrijgen is via de ontwikkelaarstools van je browser: klik in het paneel Netwerk met de rechtermuisknop op een verzoek en kies Kopiëren als cURL. In API-documentatie worden voorbeelden ook vaak als curl-opdrachten weergegeven.

Zo gebruik je de tool

  1. Plak de curl-opdracht. Lange opdrachten mogen over meerdere regels worden verdeeld, met een backslash aan het einde van elke regel, zoals shells verwachten.
  2. Kies de programmeertaal.
  3. Kopieer de code of download deze als bestand (request.mjs voor JavaScript, request.py voor Python).

De code wordt bijgewerkt terwijl je typt. Als de opdracht een fout bevat waardoor curl zelf niet verder kan, zoals een niet-afgesloten aanhalingsteken of een onbekende optie, wijst de tool je daarop.

Wat wordt omgezet

  • De methode, inclusief de methoden die curl zelf kiest: -d en -F gebruiken POST, -I HEAD en -T PUT.
  • De URL, inclusief eventuele queryparameters die -G of --url-query toevoegt.
  • Headers van -H, de user-agent van -A, de verwijzer van -e en cookies van -b. In Python worden die omgezet in een cookies-dict.
  • Basisauthenticatie via -u of de URL, met de eigen methode van elke bibliotheek om deze te versturen, en Bearer-tokens via --oauth2-bearer. In Python wordt ook Digest-authenticatie ondersteund.
  • Inhoud: JSON van --json of een JSON Content-Type wordt omgezet in een object of dict, formuliergegevens van -d in URLSearchParams of een dict, en multipart-formulieren van -F in FormData of een files-dict, inclusief bestandsuploads.
  • De time-out van --max-time (en --connect-timeout in Python), -k om TLS-controles over te slaan, CA- en clientcertificaten en een proxy van -x.

Headers die curl zelf toevoegt, zoals de eigen User-Agent, Accept: */* en Content-Length, worden weggelaten, omdat de bibliotheken hun eigen headers versturen. Opties die alleen bepalen hoe curl het antwoord weergeeft, zoals -s of -v, worden ook weggelaten.

Wanneer iets niet kan worden omgezet

Sommige zaken hebben geen equivalent in een bibliotheek of programmeertaal. Deze worden bovenaan de code als opmerkingen vermeld, zodat er niets ongemerkt wordt weggelaten:

  • Opties zonder equivalent, zoals --retry, worden vermeld als ‘Niet omgezet’.
  • fetch kan geen TLS-controles overslaan, geen proxy gebruiken en geen verbindingstime-out instellen. Browsers staan scripts bovendien niet toe de Cookie-header in te stellen, maar Node.js wel.
  • Bestanden die curl leest, zoals -d @data.json of -F photo=@cat.jpg, worden in Node.js en Python van schijf gelezen. In JavaScript voor browsers verschijnen ze als tijdelijke aanduiding die je moet vervangen, bijvoorbeeld door een bestand uit een <input type="file">.
  • Als een opdracht meerdere verzoeken verstuurt, wordt de code voor het eerste verzoek gegenereerd.

Voorbeelden

  • curl https://example.com/ wordt in Python omgezet in requests.get("https://example.com/").
  • curl -u ada:secret https://api.example.com/me wordt in Python omgezet in auth=("ada", "secret") en in Axios in een auth-optie.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders wordt in Python omgezet in json={"item": "sourdough loaf"} en met fetch in JSON.stringify({ item: "sourdough loaf" }).

Hoe het werkt

De opdracht wordt gelezen zoals een shell en curl dat doen, met aanhalingstekens, escape-tekens en regelvoortzettingen. Hiervoor wordt dezelfde parser gebruikt als door de cURL-opdrachtvalidator van de site. Vervolgens wordt het verzoek dat curl zou versturen, omgezet in code. Alles gebeurt in je browser, dus opdrachten met tokens of wachtwoorden verlaten je apparaat niet.

Functies

  • JavaScript fetch, Node.js Axios en Python Requests
  • Headers, cookies, basis- en Bearer-authenticatie
  • JSON-, formulier-, multipart- en bestandsinhoud
  • Time-outs, TLS-opties, certificaten en proxy's
  • Opmerkingen bij alles wat niet kan worden omgezet
  • Duidelijke meldingen bij fouten in de opdracht
  • De code kopiëren of downloaden
  • Werkt in je browser