Mitä se tekee?

cURL-koodimuunnin muuntaa curl-komennon koodiksi, joka lähettää saman HTTP-pyynnön omasta ohjelmastasi. Se tuottaa kolmenlaista koodia:

  • JavaScript (fetch): selaimiin, Denoon, Buniin ja Node.js:ään sisäänrakennettu fetch API.
  • Node.js (Axios): suosittu Axios-kirjasto sekä Node.js-moduulit tiedostoja ja TLS-asetuksia varten.
  • Python (Requests): Requests-kirjasto.

Yleinen tapa saada komento on käyttää selaimen kehittäjätyökaluja: avaa Verkko-paneeli, napsauta pyyntöä hiiren oikealla painikkeella ja valitse Kopioi cURL-komentona. Myös API-dokumentaatiossa esimerkit esitetään usein curl-komentoina.

Käyttöohjeet

  1. Liitä curl-komento. Pitkät komennot voivat olla usealla rivillä, kunhan kunkin rivin lopussa on kenoviiva, kuten shellit edellyttävät.
  2. Valitse ohjelmointikieli.
  3. Kopioi koodi tai lataa se tiedostona (request.mjs JavaScriptiä varten, request.py Pythonia varten).

Koodi päivittyy kirjoittaessasi. Jos komennossa on virhe, joka estäisi curlia toimimasta, kuten sulkematon lainausmerkki tai tuntematon valitsin, työkalu ilmoittaa siitä.

Mitä muunnetaan

  • HTTP-metodi, myös curlin itse valitsemat metodit: -d ja -F käyttävät POST-metodia, -I HEAD-metodia ja -T PUT-metodia.
  • URL sekä kyselyparametrit, jotka -G tai --url-query lisää.
  • Otsakkeet valitsimesta -H, käyttäjäagentti valitsimesta -A, viittaaja valitsimesta -e ja cookies valitsimesta -b; Python-koodissa cookies muunnetaan cookies-sanakirjaksi.
  • Perustunnistautuminen valitsimesta -u tai URL-osoitteesta käyttäen kunkin kirjaston omaa tapaa sen lähettämiseen sekä Bearer-tokenit valitsimesta --oauth2-bearer. Python-koodiin lisätään myös Digest-tunnistautuminen.
  • Rungot: --json-valitsimen tai JSON Content-Type -otsakkeen sisältämä JSON muunnetaan objektiksi tai sanakirjaksi, -d-valitsimen sisältämä lomakedata URLSearchParams-olioksi tai sanakirjaksi ja -F-valitsimen sisältämät moniosaiset lomakkeet FormData-olioksi tai files-sanakirjaksi, joka sisältää myös tiedostolataukset.
  • Aikakatkaisu valitsimesta --max-time (sekä --connect-timeout Pythonissa), -k TLS-tarkistusten ohittamiseen, CA- ja asiakasvarmenteet sekä välityspalvelin valitsimesta -x.

Curlin itse lisäämät otsakkeet, kuten sen oma User-Agent, Accept: */* ja Content-Length, jätetään pois, sillä kirjastot lähettävät omansa. Myös valitsimet, jotka vaikuttavat vain siihen, miten curl näyttää vastauksen, kuten -s tai -v, jätetään pois.

Kun muuntaminen ei onnistu

Kaikille asioille ei ole vastinetta kirjastossa tai ohjelmointikielessä. Tällaiset asiat lisätään koodin alkuun kommentteina, jotta mitään ei jää huomaamatta:

  • Valitsimet, joille ei ole vastinetta, kuten --retry, luetellaan kohdassa ”Ei muunnettu”.
  • fetch ei voi ohittaa TLS-tarkistuksia, käyttää välityspalvelinta tai asettaa yhteyden aikakatkaisua. Selaimet eivät myöskään salli skriptien asettaa Cookie-otsaketta, vaikka Node.js sallii sen.
  • Curlin lukemat tiedostot, kuten -d @data.json tai -F photo=@cat.jpg, luetaan levyltä Node.js:ssä ja Pythonissa. Selainympäristön JavaScriptissä niiden tilalla on paikkamerkki, jonka voit korvata itse esimerkiksi tiedostolla, joka valitaan <input type="file">-elementillä.
  • Jos komento lähettää useita pyyntöjä, koodi tuotetaan ensimmäistä pyyntöä varten.

Esimerkkejä

  • curl https://example.com/ muuntuu Pythonissa muotoon requests.get("https://example.com/").
  • curl -u ada:secret https://api.example.com/me muuntuu Pythonissa muotoon auth=("ada", "secret") ja Axiosissa auth-asetukseksi.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders muuntuu Pythonissa muotoon json={"item": "sourdough loaf"} ja fetch-kutsussa muotoon JSON.stringify({ item: "sourdough loaf" }).

Miten se toimii

Komento luetaan samalla tavalla kuin shell ja curl sen lukevat: lainausmerkit, kenoviivalla tehdyt merkinnät ja rivijatkot huomioiden. Lukemiseen käytetään samaa jäsennintä kuin sivuston cURL-komennon tarkistimessa. Sen jälkeen tulosteeksi muodostetaan koodi pyynnöstä, jonka curl lähettäisi. Kaikki tapahtuu selaimessasi, joten tokenit tai salasanat sisältävät komennot eivät poistu laitteeltasi.

Ominaisuudet

  • JavaScript fetch, Node.js Axios ja Python Requests
  • Otsakkeet, cookies sekä Basic- ja Bearer-tunnistautuminen
  • JSON-, lomake-, moniosaiset ja tiedostorungot
  • Aikakatkaisut, TLS-asetukset, varmenteet ja välityspalvelimet
  • Kommentit asioista, joita ei voi muuntaa
  • Selkeät virheilmoitukset komentojen virheistä
  • Koodin kopiointi tai lataaminen
  • Toimii selaimessasi