cURL ile HTTP Üstbilgileri Nasıl Gönderilir? Örneklerle Kapsamlı Bir Kılavuz

HTTP üstbilgilerini cURL ile göndermek, API'ler veya web hizmetleriyle çalışan herkes için temel bir beceridir. HTTP üstbilgileri, isteğinizle ilgili içerik türü, yetkilendirme ve daha fazlası gibi önemli bilgileri iletir. HTTP istekleri yapmak için güçlü bir komut satırı aracı olan cURL, bu başlıkları zahmetsizce özelleştirmenize ve göndermenize olanak tanır. Bu kılavuzda, çeşitli pratik örneklerle birlikte cURL kullanarak HTTP başlıklarını gönderme sürecinde size yol göstereceğiz.

Önkoşullar

Örneklere dalmadan önce sisteminizde cURL'nin kurulu olduğundan emin olun. Aşağıdakileri çalıştırarak kurulu olup olmadığını kontrol edebilirsiniz:

curl --version

Yüklü değilse resmi cURL web sitesinden indirebilirsiniz.

Temel cURL Söz Dizimi

cURL ile bir HTTP isteği göndermenin temel sözdizimi şöyledir:

curl [options] [URL]

İsteğinize HTTP başlıklarını dahil etmek için -H veya –header seçeneğini ve ardından başlık bilgisini kullanabilirsiniz.

Örnek 1: Özel Başlıklarla GET İsteği Gönderme

Özel bir başlık da dahil olmak üzere varsayımsal bir API'ye basit bir GET isteğiyle başlayalım. API anahtarınıza bir "Yetkilendirme" başlığı eklemek istediğinizi varsayalım.

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.example.com/resource

YOUR_API_KEY'inizi gerçek API anahtarınızla değiştirin.

Örnek 2: JSON Verileriyle POST İsteği Gönderme

Bu örnekte, JSON verisi ve özel içerik türü başlığıyla bir POST isteği göndereceğiz.

curl -X POST -H "Content-Type: application/json" -d '{"name": "John", "email": "[email protected]"}' https://api.example.com/users

Bu komut, istek yöntemini POST (-X POST) olarak belirtir, içerik türünü JSON (-H “Content-Type: application/json”) olarak ayarlar ve -d ile JSON verilerini içerir.

Örnek 3: Birden Fazla Başlığın Ayarlanması

Tek bir cURL isteğine birden fazla başlık ekleyebilirsiniz. Burada hem “Authorization” hem de “User-Agent” başlıklarıyla istek gönderiyoruz.

curl -H "Authorization: Bearer YOUR_API_KEY" -H "User-Agent: MyClient/1.0" https://api.example.com/resource

Örnek 4: Çerezlerin Gönderilmesi

İsteğinizle birlikte çerez göndermek için -b veya –cookie seçeneğini ve ardından çerez verilerini kullanın.

curl -b "session=12345; preferences=darkmode" https://api.example.com/dashboard

Bu örnek iki çerez göndermektedir: "oturum" ve "tercihler".

Örnek 5: Yönlendirmeleri Takip Etme

Varsayılan olarak cURL, HTTP yönlendirmelerini izlemez. Yönlendirme takibini etkinleştirmek için -L veya –location seçeneğini kullanın.

curl -L https://example.com

Bu komut tüm yönlendirmeleri izleyecek ve son sayfa içeriğini gösterecektir.

Örnek 6: Özel Kullanıcı Aracısı Gönderme

İsteğinizi tanımlamak için özel bir Kullanıcı Aracısı başlığı ayarlayabilirsiniz.

curl -H "User-Agent: MyCustomApp/1.0" https://api.example.com/resource

Özel Kullanıcı Aracısı üstbilgileri, belirli kullanıcı aracıları gerektiren API'lerle etkileşimde bulunulurken kullanışlıdır.

Örnek 7: Veri Olmadan İstek Başlıklarını Gönderme

İstek gövdesi olmayan bir başlık göndermeniz gerekiyorsa -I veya –head seçeneğini kullanabilirsiniz.

curl -I https://api.example.com/resource

Bu komut, gerçek içeriği değil yalnızca başlıkları getiren bir HEAD isteği gönderir.

Örnek 8: Temel Kimlik Doğrulamanın Gönderilmesi

HTTP Temel Kimlik Doğrulama kimlik bilgilerini göndermek için Base64'te kodlanmış kullanıcı adınızı ve şifrenizi içeren bir "Yetkilendirme" başlığı ekleyebilirsiniz.

curl -H "Authorization: Basic BASE64_ENCODED_CREDENTIALS" https://api.example.com/resource

BASE64_ENCODED_CREDENTIALS'ı Base64 kodlu kullanıcı adınız ve şifrenizle değiştirin (örn. kullanıcı adı:şifre).

Örnek 9: Hata Ayıklama ve Ayrıntılı Mod

Sorunları giderirken veya HTTP isteğini ve yanıtını incelerken cURL'nin ayrıntılı modunu -v veya –verbose seçeneğiyle kullanabilirsiniz.

curl -v https://api.example.com/resource

Bu, başlıklar da dahil olmak üzere istek ve yanıtla ilgili ayrıntılı bilgileri görüntüleyecektir.

HTTP üstbilgilerini cURL ile göndermek, web hizmetleri ve API'lerle çalışmak için çok önemli bir beceridir. Bu kılavuzda verilen örneklerle isteklerinizi özelleştirebilir, kimlik doğrulamayı gerçekleştirebilir, çerez gönderebilir ve daha fazlasını yapabilirsiniz. cURL'nin yeteneklerine aşina oldukça, çeşitli web hizmetleriyle etkili bir şekilde etkileşimde bulunmak için iyi bir donanıma sahip olacaksınız.