curl, komut satırından HTTP istekleri yapmak için en yaygın kullanılan araçlardan biridir. Dosya indirmeden API testlerine kadar birçok alanda karşımıza çıkar. Özellikle REST API'leri test ederken, isteğe özel başlıklar (header) eklemek sıkça ihtiyaç duyulan bir işlemdir. Bu makalede, curl ile bir HTTP isteğine nasıl başlık ekleneceğini adım adım inceleyeceğiz.
curl ile başlık eklemenin en temel yolu -H (veya --header) parametresini kullanmaktır. Bu parametre, isteğe bir veya daha fazla HTTP başlığı eklemenizi sağlar. Örneğin, bir API'ye JSON formatında yanıt almak için 'accept: application/json' başlığını ekleyebilirsiniz. Aynı anda birden fazla başlık eklemek için -H parametresini tekrarlayabilirsiniz.
İşte bir örnek: curl -X 'GET' 'https://api.ornek.com/veri' -H 'accept: application/json' -H 'Version: 1' Bu komut, hedef URL'ye bir GET isteği gönderir ve iki başlık ekler: 'accept: application/json' ve 'Version: 1'. -X parametresi ise HTTP metodunu belirtir (GET, POST, PUT, DELETE vb.).
Başlık eklerken dikkat edilmesi gereken bazı noktalar vardır. Başlık adı ve değeri iki nokta üst üste (:) ile ayrılmalıdır. Başlık adı büyük/küçük harf duyarsızdır, ancak genellikle ilk harfleri büyük yazılır. Ayrıca, özel karakterler veya boşluklar içeren başlık değerleri tırnak içine alınmalıdır. Çoklu başlıklarda her bir başlık için ayrı bir -H parametresi kullanılır.
Pratikte, API testlerinde sıkça kullanılan başlıklar arasında Authorization (Bearer token), Content-Type, Accept, User-Agent ve özel API anahtarları bulunur. Örneğin, bir JWT token ile kimlik doğrulama yapmak için: curl -H 'Authorization: Bearer
Sonuç ve Değerlendirme
curl ile başlık ekleme işlemi, özellikle RESTful API'lerin test edilmesinde kritik bir rol oynar. API'ler genellikle istek başlıklarına göre yanıt formatını (JSON, XML) belirler veya kimlik doğrulama bilgilerini başlıklar aracılığıyla alır. Bu nedenle, doğru başlıkları eklemek API'den beklenen yanıtı almanın anahtarıdır.
Sonuç olarak, curl ile HTTP başlığı eklemek oldukça basit ve güçlü bir özelliktir. -H parametresini kullanarak isteğinize istediğiniz başlığı ekleyebilir, API testlerinizi daha esnek hale getirebilirsiniz. Unutmayın, doğru başlıklar doğru yanıtları getirir. Şimdi siz de terminalinizi açın ve curl ile başlık ekleme denemeleri yaparak bu güçlü aracı keşfedin.
Kaynak: davidwalsh.name
