cURL Dönüştürücü

cURL dönüştürücü nedir?

Bir cURL dönüştürücü, her API dokümantasyonunun, Postman dışa aktarımının ve yapay zekâ asistanının ürettiği curl komutunu alıp gerçek programlama dilinde yapıştırmaya hazır koda çevirir. Başlıklar, query string'ler, JSON gövdeler, multipart yüklemeleri, basic auth ve çerezler birebir taşınır; böylece isteği elle çevirmek zorunda kalmazsın.

curl, bir HTTP isteğini tarif etmenin evrensel yoludur; ama production'da neredeyse hiç *curl çalıştırmazsın*. Çalıştırdığın şey JavaScript fetch, Python requests, Go'nun net/http paketi ya da stack'inde ne varsa odur. Bu araç o boşluğu kapatır: curl'ü yapıştır, sekmeye tıkla, kodu kopyala.

Her şey tarayıcında, yerel olarak çalışır. curl komutun, başlıkların ve token'ların makinenden dışarı çıkmaz - gerçek bearer token veya session çerezi içeren komutları yapıştırırken bu çok işine yarar.

Dönüştürürken neler öğreneceksin

• curl flag'leri her HTTP istemcisindeki belirli kavramlara karşılık gelir: -H bir istek başlığı, -d bir gövde, -X bir method, -u basic auth ve -F bir multipart form alanıdır.
• curl bir gövde (-d, --data, -F) görürse ve -X belirtilmemişse varsayılan olarak POST kullanır - çoğu istemcinin de varsayılanı aynıdır, dolayısıyla -X belirtilmemiş olsa bile çıktıda POST görürsün.
• JSON gövdeler ile form gövdeleri farklıdır. Content-Type: application/json, gövdenin olduğu gibi gönderildiği anlamına gelir; application/x-www-form-urlencoded ise anahtar/değer çiftlerinin & ile birleştirildiği anlamına gelir.
• -G, GET istekleri için gövdeyi query string'e taşır. Çıktı bunu yansıtır - params / query dolu olur ve gövde gönderilmez.

Adım adım curl komutunu koda dönüştürme

1. 1

   curl komutunu yapıştır

   Tam komutu - kopyala-yapıştır yaptığın dokümanlardan gelen \ satır birleştirmeleri dahil - giriş kutusuna bırak. Ayrıştırıcı, akıllı tırnakları ve PowerShell prompt işaretlerini otomatik olarak normalize eder.

2. 2

   Hedef dili seç

   Sekmeler şunları kapsar: JavaScript fetch, TypeScript, Node axios, Python requests, Python httpx, Go, PHP, Ruby, Java HttpClient, C# HttpClient, HTTPie ve PowerShell. Sekme değiştirmek ücretsizdir - ayrıştırma bir kez çalışır.

3. 3

   Ayrıştırılan isteği incele

   *Ayrıştırılan istek* panelini açarak method, URL, başlıklar, gövde türü ve insecure veya follow redirects gibi seçeneklerin beklediğin gibi taşınıp taşınmadığını doğrula.

4. 4

   Kodu kopyala ve kimlik doğrulamayı ayarla

   Üretilen kodu projene kopyala. curl bir bearer token veya çerez içeriyorsa, commit etmeden önce literal değeri bir ortam değişkeniyle değiştir.

cURL flag'leri hızlı referansı

Bu dönüştürücünün anladığı flag'ler ve üretilen kodda neye karşılık geldikleri.

cURL dönüştürme örnekleri

curl 'https://api.example.com/v1/lessons?limit=20&track=python' \  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.demo'

const response = await fetch('https://api.example.com/v1/lessons?limit=20&track=python', {  method: 'GET',  headers: {    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiJ9.demo'  }});const data = await response.json();

curl 'https://api.example.com/v1/users' \  -H 'Content-Type: application/json' \  --data-raw '{"name":"Ada","age":36}'

import requests
headers = {    'Content-Type': 'application/json',}json_data = {"name":"Ada","age":36}
response = requests.post('https://api.example.com/v1/users', headers=headers, json=json_data)response.raise_for_status()

curl 'https://api.example.com/upload' \  -F 'caption=Hello' \  -F 'photo=@./avatar.jpg'

import requests
files = {    'caption': (None, 'Hello'),    'photo': open('./avatar.jpg', 'rb'),}
response = requests.post('https://api.example.com/upload', files=files)response.raise_for_status()

curl 'https://api.example.com/me' \  -u alice:s3cret \  -b 'session=2f9a; theme=dark'

const response = await fetch('https://api.example.com/me', {  method: 'GET',  headers: {    'Authorization': 'Basic YWxpY2U6czNjcmV0',    'Cookie': 'session=2f9a; theme=dark'  }});

curl dönüştürürken sık yapılan hatalar

• Bir blog yazısından akıllı tırnaklı (', ', ", ") curl yapıştırmak - tırnak gibi görünürler ama shell ayrıştırmasını bozarlar. Dönüştürücü bunları normalize eder, ama mümkünse orijinal komutu kopyala.
• production'da -k (--insecure) bırakmak. TLS sertifika doğrulamasını devre dışı bırakır - yerel geliştirme için sorun değil, gerçek trafikte tehlikelidir.
• --data-raw ile --data'nın farklı davrandığını unutmak - --data girdiyi URL kodlar. @ veya & içeren JSON gövdeler için --data-raw kullan.
• Windows curl.exe komutunu ^ satır birleştirmelerini \ olarak çevirmeden yapıştırmak. Dönüştürücü bunu halleder, ama ayrıştırıcı tırnaklar konusunda katıdır - string sınırlarını iki kez kontrol et.
• Dönüştürdükten sonra bearer token'ları veya çerezleri sürüm kontrolüne kopyalamak. Commit'lemeden önce bunları ortam değişkenlerine (process.env.API_TOKEN, os.environ['API_TOKEN']) taşı.

cURL Dönüştürücü SSS