curl, belki de yıllardır var olan ve sayısız kullanım senaryosuna sahip en kullanışlı araçlardan biridir. Bugünlerde curl'ü toplu dosya indirme ve API'leri test etmek için sıkça kullanıyorum. Testlerim bazen isteklerimde farklı HTTP başlıkları (header) kullanmamı gerektiriyor. API'lerle çalışırken, doğru başlıkları göndermek genellikle başarılı bir yanıt almanın anahtarıdır. İşte bu noktada curl'ün -H flag'i devreye giriyor.
curl ile bir isteğe header eklemek oldukça basittir. Bunun için -H (veya --header) flag'ini kullanmanız yeterlidir. Örneğin, bir API'den JSON formatında veri almak için 'accept: application/json' başlığını ekleyebilirsiniz. Aynı anda birden fazla header da ekleyebilirsiniz. İşte tipik bir kullanım: 'curl -X GET https://api.example.com/data -H 'accept: application/json' -H 'Version: 1'. Bu komut, API'ye bir GET isteği gönderir ve iki farklı header ekler: accept ve Version.
Peki -H flag'i tam olarak nasıl çalışır? -H'den sonra tırnak içinde 'Header-Adı: Değer' formatında bir çift belirtirsiniz. Header adı ve değeri iki nokta üst üste ile ayrılır. curl, bu bilgiyi HTTP isteğinin başlık kısmına ekler. Aynı anda birden fazla -H kullanarak istediğiniz kadar header ekleyebilirsiniz. Ayrıca, curl'ün varsayılan olarak eklediği bazı başlıkları (örneğin User-Agent) -H ile ezebilirsiniz.
Teknik Analiz
Header eklemenin pratikte birçok kullanım alanı vardır. Örneğin, kimlik doğrulama token'larını 'Authorization: Bearer
Sistem Güvenliği
curl ile header eklerken dikkat edilmesi gereken bazı noktalar vardır. Öncelikle, header adı ve değeri doğru formatta olmalıdır. Header adları büyük/küçük harf duyarsızdır, ancak geleneksel olarak baş harfleri büyük yazılır (örneğin 'Content-Type'). Değerlerde boşluk varsa tırnak içine almanız gerekebilir. Ayrıca, aynı header'ı birden fazla kez eklerseniz, curl bunları birleştirir veya sonuncuyu kullanır (HTTP standardına bağlı olarak).
Sonuç ve Değerlendirme
Son olarak, -H flag'ini -X (isteğin türünü belirtmek için) ve -d (veri göndermek için) gibi diğer curl seçenekleriyle birlikte kullanabilirsiniz. Örneğin, bir POST isteğiyle JSON verisi gönderirken header ve body birlikte kullanılır: 'curl -X POST https://api.example.com/data -H 'Content-Type: application/json' -d '{"key":"value"}''. Bu şekilde curl, API testlerinizde size büyük esneklik sağlar. Artık siz de curl ile header ekleyerek API'lerinizi daha etkin bir şekilde test edebilirsiniz.
Kaynak: davidwalsh.name
