Ne işe yarar?

cURL'den Koda Dönüştürücü, bir curl komutunu kendi programınızdan aynı HTTP isteğini gönderen koda dönüştürür. Üç tür kod üretir:

  • JavaScript (fetch): Tarayıcılarda, Deno'da, Bun'da ve Node.js'te yerleşik olan fetch API.
  • Node.js (Axios): Dosyalar ve TLS ayarları için Node.js modüllerini kullanan popüler Axios kütüphanesi.
  • Python (Requests): Requests kütüphanesi.

Komut almanın yaygın bir yolu, tarayıcınızın geliştirici araçlarını kullanmaktır: Network panelinde bir isteğe sağ tıklayın ve cURL olarak kopyala'yı seçin. API belgelerinde de örnekler sık sık curl komutları olarak gösterilir.

Nasıl kullanılır?

  1. curl komutunu yapıştırın. Uzun komutlar, shell'lerin beklediği gibi, her satırın sonunda ters eğik çizgi olacak şekilde birkaç satıra yayılabilir.
  2. Dili seçin.
  3. Kodu kopyalayın veya dosya olarak indirin (JavaScript için request.mjs, Python için request.py).

Siz yazdıkça kod güncellenir. Komutta curl'ün çalışmasını engelleyecek kapatılmamış tırnak işareti veya bilinmeyen bir seçenek gibi bir hata varsa araç bunu belirtir.

Neler dönüştürülür?

  • Yöntem; curl'ün kendisinin seçtiği yöntemler de buna dahildir: -d ve -F POST, -I HEAD, -T ise PUT kullanır.
  • URL ve -G ya da --url-query ile eklenen sorgu.
  • -H ile belirtilen başlıklar, -A ile belirtilen user agent, -e ile belirtilen referrer ve Python'da cookies sözlüğüne dönüştürülen -b ile belirtilen cookies.
  • -u veya URL üzerinden belirtilen Basic kimlik doğrulaması, her kütüphanenin kendi gönderme yöntemiyle aktarılır. --oauth2-bearer ile belirtilen Bearer token'lar da aktarılır. Python'da Digest kimlik doğrulaması da desteklenir.
  • Gövdeler: --json veya JSON Content-Type ile belirtilen JSON, bir nesneye ya da sözlüğe; -d ile belirtilen form verileri URLSearchParams'e ya da sözlüğe; -F ile belirtilen çok parçalı formlar ise dosya yüklemeleri de dahil olmak üzere FormData'ya ya da files sözlüğüne dönüştürülür.
  • --max-time ile belirtilen zaman aşımı (--connect-timeout Python'da da desteklenir), TLS denetimlerini atlamak için -k, CA ve istemci sertifikaları ile -x ile belirtilen proxy.

curl'ün kendisinin eklediği User-Agent, Accept: */* ve Content-Length gibi başlıklar, kütüphaneler kendi başlıklarını gönderdiği için eklenmez. -s veya -v gibi yalnızca curl'ün yanıtı gösterme biçimini değiştiren seçenekler de eklenmez.

Dönüştürülemeyenler

Bazı öğelerin bir kütüphanede veya dilde karşılığı yoktur. Hiçbir şey sessizce atlanmasın diye bunlar kodun başında yorum olarak gösterilir:

  • --retry gibi karşılığı olmayan seçenekler "Dönüştürülmedi" olarak listelenir.
  • fetch, TLS denetimlerini atlayamaz, proxy kullanamaz veya bağlantı zaman aşımı ayarlayamaz. Ayrıca Node.js'in aksine tarayıcılar, betiklerin Cookie başlığını ayarlamasına izin vermez.
  • curl'ün diskten okuduğu -d @data.json veya -F photo=@cat.jpg gibi dosyalar Node.js ve Python'da diskten okunur. Tarayıcıdaki JavaScript'te ise bunlar, örneğin <input type="file"> öğesinden seçilen bir dosyayla değiştirmeniz için yer tutucu olarak gösterilir.
  • Bir komut birden fazla istek gönderiyorsa kod yalnızca ilk istek için oluşturulur.

Örnekler

  • curl https://example.com/, Python'da requests.get("https://example.com/") olur.
  • curl -u ada:secret https://api.example.com/me, Python'da auth=("ada", "secret"), Axios'ta ise bir auth seçeneği olur.
  • curl --json '{"item": "sourdough loaf"}' https://api.example.com/orders, Python'da json={"item": "sourdough loaf"}, fetch ile ise JSON.stringify({ item: "sourdough loaf" }) olur.

Nasıl çalışır?

Komut; tırnak işaretleri, kaçış karakterleri ve satır devamlarıyla birlikte, shell ve curl'ün okuduğu biçimde, sitenin cURL Komut Doğrulayıcısı ile aynı ayrıştırıcı kullanılarak okunur. Ardından curl'ün göndereceği istek kod olarak yazılır. Tüm işlemler tarayıcınızda gerçekleşir; bu nedenle token veya parola içeren komutlar cihazınızdan ayrılmaz.

Özellikler

  • JavaScript fetch, Node.js Axios ve Python Requests
  • Başlıklar, cookies, Basic ve Bearer kimlik doğrulaması
  • JSON, form, çok parçalı form ve dosya gövdeleri
  • Zaman aşımları, TLS seçenekleri, sertifikalar ve proxy'ler
  • Dönüştürülemeyen her şey için yorumlar
  • Komut hataları için anlaşılır mesajlar
  • Kodu kopyalama veya indirme
  • Tarayıcınızda çalışır