cURL Komut Oluşturucu ve Yapılandırıcı

curl Komutu Nedir?

# Plain GET — curl defaults to GET
curl https://api.example.com/users

# GET with a Bearer token (auth is just a header)
curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

# POST a JSON body — note the Content-Type header
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

# Multipart file upload — '@' reads the file from disk
curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

Temel Özellikler

curl Alternatifleri ve HTTP İstemcileri

curl Komut Örnekleri

curl https://api.example.com/users

curl https://api.example.com/me \
  -H 'Authorization: Bearer YOUR_TOKEN'

curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada","role":"admin"}'

curl -X POST https://api.example.com/login \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'username=ada&password=s3cret'

curl -X POST https://api.example.com/upload \
  -F 'file=@report.pdf' \
  -F 'title=Q3 report'

curl -L -o archive.zip \
  https://example.com/files/archive.zip

curl -u ada:s3cret \
  https://api.example.com/private

curl -v -i https://api.example.com/health

curl Komutu Nasıl Oluşturulur

1. 1

   HTTP yöntemini seçin

   GET, POST, PUT, PATCH, DELETE, HEAD veya OPTIONS seçin. curl varsayılan olarak GET kullanır; POST veya başka bir fiil seçmek oluşturulan komuta -X METHOD ekler. Veya yöntemi ve eşleşen gövdeyi tek tıklamayla ayarlamak için bir ön ayar yongasına dokunun.

2. 2

   URL ve sorgu parametrelerini girin

   İstek URL'sini girin (ör. https://api.example.com/users). Sorgu parametrelerini anahtar/değer çiftleri olarak ekleyin; araç bunları URL kodlar ve ?key=value&… şeklinde otomatik olarak URL'ye ekler — manuel kodlama gerekmez.

3. 3

   Başlıklar ve kimlik doğrulama ekleyin

   İstek başlıklarını anahtar/değer çiftleri olarak ekleyin, ardından bir kimlik doğrulama şeması seçin: Yok, Bearer token, Temel (kullanıcı adı/şifre) veya özel API-anahtar başlığı. Sunucunun beklediği tam biçimde doğru Authorization veya özel başlık oluşturulur.

4. 4

   İstek gövdesini ayarlayın

   POST/PUT/PATCH için bir gövde türü seçin: ham JSON yapıştırın (Content-Type başlığı sizin için eklenir), url kodlanmış form alanları oluşturun veya çok parçalı bir yükleme oluşturup @ önekiyle herhangi bir alanı dosyaya geçirin.

5. 5

   Seçenekleri açın

   İhtiyacınız olan bayrakları açın — yönlendirmeleri izle (-L), güvensiz TLS (-k), ayrıntılı (-v), başlıkları dahil et (-i), sıkıştırılmış (--compressed), dosyaya çıkış (-o), bağlantı zaman aşımı veya proxy (-x). Her geçiş komutu canlı olarak günceller.

6. 6

   Kopyalayın, dışa aktarın veya sıfırlayın

   Tamamlanan komutu kopyalayın, betik olarak indirmek için .sh Dışa Aktar'ı kullanın veya formu temizlemek için Sıfırla'yı tıklayın. Kopyalamadan önce tek satırlı ve ters eğik çizgiyle devam eden çıkış arasında geçiş yapmak için Çok satırlı geçişini kullanın.

Yaygın curl Hataları

# PATCH amaçlandı, ancak -d tek başına POST anlamına gelir
curl -d '{"role":"admin"}' \
  https://api.example.com/users/7

# Fiili açıkça belirtin
curl -X PATCH -d '{"role":"admin"}' \
  -H 'Content-Type: application/json' \
  https://api.example.com/users/7

# Sunucu JSON değil urlencoded görür — 400/415
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

# JSON içerik türünü bildirin
curl -X POST https://api.example.com/users \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ada"}'

# $name shell tarafından boş dizeye genişletilir
curl -d "{\"user\":\"$name\"}" \
  https://api.example.com/users

# Tek tırnaklar gövdeyi olduğu gibi gönderir
curl -d '{"user":"$name"}' \
  https://api.example.com/users

# -d bunu GET değil POST yapar
curl -d 'page=2&limit=50' \
  https://api.example.com/users

# URL'deki sorgu dizesi onu GET olarak tutar
curl 'https://api.example.com/users?page=2&limit=50'

:: cmd.exe — ters eğik çizgi devam karakteri değil
curl -X POST https://api.example.com/users \
  -d '{"name":"Ada"}'

:: cmd.exe — tek satır veya devam için ^ kullanın
curl -X POST https://api.example.com/users -d "{\"name\":\"Ada\"}"

# Boşluk argümanı böler — curl iki argüman görür
curl https://api.example.com/search?q=hello world

# Boşluğu kodlayın (veya tüm URL'yi tırnaklayın)
curl 'https://api.example.com/search?q=hello%20world'

Yaygın Kullanım Durumları

REST API Testi

Terminali terk etmeden bir REST uç noktasına karşı istek oluşturun ve gönderin: yöntemi ayarlayın, bir Bearer token yapıştırın, JSON gövdesi gönderin ve yanıtı okuyun. İstemci kodu yazmadan önce bir API'nin doğru davranıp davranmadığını doğrulamanın en hızlı yolu.

Belgelerden İsteği Yeniden Oluşturma

API belgeleri uç noktaları ve parametreleri gösterir ancak nadiren eksiksiz, kopyalamaya hazır bir komut sunar. Yöntemi, URL'yi, başlıkları ve kimlik doğrulamayı burada doldurun ve olduğu gibi çalışan bir curl komutu alın — alıntılama veya eksik Content-Type başlıklarıyla boğuşmadan.

CI/CD Duman Testi Betikleri

Sağlık kontrolü veya dağıtım sonrası duman testi için bir curl komutu oluşturun, ardından bir boru hattına eklemek için .sh Dışa Aktar'ı kullanın. Takılı bir uç noktanın yapıyı engelleyememesi için --connect-timeout ve --max-time ekleyin ve -w ile durum kodlarını kontrol edin.

Dosya Yükleme ve İndirme

Bir -F field=@file ile multipart/form-data yüklemesi oluşturun ya da CDN'ye yönlendirmeleri takip eden bir -L -o filename indirmesi oluşturun. Zorlu dosya adlarını veya sorgu değerlerini önce URL kodlayıcımızla kodlayın.

Webhook Hata Ayıklama

Sağlayıcının gönderdiği aynı JSON gövdesini, doğru imza ve Content-Type başlıklarıyla POST ederek bir webhook yükünü tekrarlayın. İşleyicinizin neden reddettiğini hata ayıklamak için tam isteği yerel olarak yeniden oluşturun.

Yeniden Üretilebilir Hata Raporları

Herkesin tam isteği yeniden üretebilmesi için bir hata raporuna veya PR'a tek, bağımsız bir curl komutu yapıştırın — yöntem, başlıklar, kimlik doğrulama yer tutucusu ve gövde. İsteği düzyazıyla açıklamaktan çok daha net.

curl Bayraklarını Öğrenme

Her form seçiminin gerçek bir bayrakla nasıl eşleştiğini görün — Temel kimlik doğrulamayı seçin ve -u göründüğünü izleyin, JSON gövdesi ekleyin ve Content-Type başlığının eklendiğini izleyin. curl kopya kağıdımızla eşleştirilmiş, sözdizimini öğrenmek için uygulamalı bir yol.

Koda Dönüştürmek İçin İstek Hazırlama

İsteği önce curl olarak oluşturun ve doğrulayın, ardından uygulamanızın HTTP istemcisine çevirin. Yaklaşan Dönüştür sekmesi, yapıştırılan bir curl komutunu fetch, requests, Go, PHP, Ruby ve Node.js'e dönüştürecek — çalıştığını bildiğiniz bir curl komutundan başlayın.

curl Bayrakları ve Sözdizimi Başvurusu

Shell Alıntılama ve Kaçış

Araç, değerleri tek tırnaklarla sarmalar; bu, POSIX shell'lerinde en güvenli formdur çünkü tek tırnaklı dize içindeki hiçbir şey genişletilmez. Değer içindeki literal tek tırnak, '\'' dizisi olarak yayılır (kapat-tırnak, kaçan tırnak, yeniden aç-tırnak). cmd.exe'de çift tırnaklara geçin; Git Bash ve WSL, oluşturulan tek tırnaklı komutları değişmeden çalıştırır.

-d ile --data-raw ile --data-binary

-d/--data gövdeden satır sonu ve satır başı karakterlerini kaldırır — key=value çiftleri için uygundur, çok satırlı içerik için kayıplıdır. --data-raw aynıdır ancak baştaki @'yı dosya adı olarak ele almaz. --data-binary baytları tam olarak verildiği gibi gönderir (ham dosya içeriğini yüklemek için @file kullanın). Yöntem geçersiz kılınmadıkça üçü de POST anlamına gelir.

Çok Parçalı (-F) ile URL Kodlanmış (-d)

-F field=value oluşturulan sınırla multipart/form-data üretir — dosya yüklemeleri (-F file=@yol) ve karışık dosya/metin formları için gereklidir. -d field=value, & ile birleştirilmiş tek bir dize olan application/x-www-form-urlencoded üretir. Çok parçalı için Content-Type'ı asla manuel olarak ayarlamayın; curl sınırı hesaplar ve başlığı kendisi ayarlar.

Kimlik Doğrulama Başlığı Kodlaması

Bearer kimlik doğrulama, Authorization: Bearer <token> değerini olduğu gibi gönderir (RFC 6750). -u kullanıcı:şifre ile Temel kimlik doğrulama, kablo üzerinden Authorization: Basic <base64> olarak Base64 kodlanır — şifreleme değil kodlama, bu nedenle HTTPS kullanın. API anahtarı, servisin gerektirdiği özel başlıktır, ör. X-API-Key: <değer>.

Sorgu Dizisi Kodlaması

Oluşturucuya eklenen sorgu parametreleri yüzde kodlanır ve ?key=value&key2=value2 olarak eklenir. Ayrılmış karakterler (boşluklar, &, =, #) kaçılır, böylece URL geçerli olur. Kodlanması gereken gövde alanları için curl'ün kendi --data-urlencode seçeneği, istek zamanında kodlamayı gerçekleştirir.

Yönlendirme Davranışı (-L)

-L olmadan curl bir 301/302 yanıtı yazdırır ve durur. -L ile son URL'ye Location başlığını takip eder. Bir yönlendirme farklı bir ana bilgisayara geçtiğinde curl'ün Authorization başlığını düşürdüğüne dikkat edin (güvenlik varsayılanı); --location-trusted seçeneğini yalnızca sonuçlarını anladığınızda kullanın.

Sıkıştırılmış Yanıtlar

--compressed, gzip/deflate/brotli desteğini bildiren bir Accept-Encoding başlığı ekler ve yanıtı şeffaf biçimde açar, bant genişliği tasarrufu sağlar. Kodu çözülmüş gövde, sıkıştırılmamış bir istekle aynıdır — tamamen bir aktarım optimizasyonudur, çoğu API çağrısında etkinleştirmek güvenlidir.

Çıkış: -o ile -O

-o filename yanıt gövdesini adlandırdığınız bir dosyaya yazar; -O onu URL yolundaki uzak dosya adı altında kaydeder. Her ikisi de normal stdout dökümünü bastırır. Dosya yazılmadan önce yönlendirmelerin gerçek varlığa çözümlenmesi için -L ile birleştirin.

curl İstekleri için En İyi Uygulamalar

Paylaşılan Komutlara Asla Gizli Bilgi Sabit Kodlamayın

Bir PR'a, bilete veya sohbete yapıştırdığınız bir curl komutu başkaları tarafından okunacak ve araçlar tarafından dizine eklenecektir. Token'ları ve şifreleri bir yer tutucu (YOUR_TOKEN) veya ortam değişkeni referansıyla değiştirin (-H "Authorization: Bearer $API_TOKEN"). Uzun kimlik bilgileri için curl, bir başlığı dosyadan -H @headerfile ile okuyabilir; böylece gizli bilgi asla shell geçmişinde görünmez.

İkili Yükler için --data-binary @file Kullanın

Gövde, baytları önemli olan bir dosyaysa — bir görüntü, imzalı bir yük, boşluğun önemli olduğu JSON — -d @file yerine --data-binary @file kullanın. Düz -d, satır sonlarını ve satır başlarını kaldırır; ikili ve çok satırlı içeriği sessizce bozar. --data-binary, dosyayı diskte olduğu gibi gönderir.

Başlık Değerlerini Tırnaklayın

-H değerlerini her zaman tırnaklarla sarın: -H 'Content-Type: application/json'. Tırnaksız olarak, iki noktadan sonraki boşluk argümanı böler ve curl bozuk bir başlık görür. Tek tırnaklar ayrıca shell'in değer içindeki $, * ve diğer özel karakterleri genişletmesini de durdurur — bu aracın varsayılan olarak yaydığı tam olarak budur.

Bant Genişliği Tasarrufu için --compressed Kullanın

gzip/brotli kodlaması istemek ve curl'ün şeffaf biçimde açmasını sağlamak için API çağrılarına ve indirmelere --compressed ekleyin. JSON ağırlıklı API'ler için bu, gördüğünüz yanıtta herhangi bir değişiklik olmaksızın aktarım boyutunu yüzde 70-90 oranında azaltabilir — uç noktaları tekrar tekrar yoklayan betiklerde ücretsiz bir kazanım.

Betiklerde Zaman Aşımlarını Sabitleyin

Herhangi bir otomatik bağlamda, yavaş veya takılı bir uç noktanın boru hattını sonsuza kadar engelleyememesi için --connect-timeout ve --max-time ekleyin. --max-time 10 ile bir sağlık kontrolü hızla başarısız olur ve CI'nızın devam etmesine izin verir. Hemen vazgeçmeden geçici ağ aksaklıklarını absorbe etmek için --retry N ile eşleştirin.

Otomatikleştirmeden Önce -v ile Doğrulayın

Bir curl komutunu bir betiğe veya cron işine yerleştirmeden önce, tam istek satırını, başlıkları ve TLS el sıkışmasını görmek için bir kez -v ile çalıştırın. Yanlış bir yöntemi, eksik bir Content-Type'ı veya eklenmemiş bir kimlik doğrulama başlığını yakalamanın en hızlı yoludur — etkileşimli olarak hata ayıklayın, ardından üretim için -v'yi kaldırın.

Sıkça Sorulan Sorular