{"id":34517,"date":"2025-11-18T04:01:09","date_gmt":"2025-11-18T01:01:09","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/c-gelistiricisinin-curl-kopyala-yapistir-cikmazi-bir-cozum-rehberi\/"},"modified":"2025-11-18T04:01:09","modified_gmt":"2025-11-18T01:01:09","slug":"c-gelistiricisinin-curl-kopyala-yapistir-cikmazi-bir-cozum-rehberi","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/c-gelistiricisinin-curl-kopyala-yapistir-cikmazi-bir-cozum-rehberi\/","title":{"rendered":"C# Geli\u015ftiricisinin CURL Kopyala-Yap\u0131\u015ft\u0131r \u00c7\u0131kmaz\u0131: Bir \u00c7\u00f6z\u00fcm Rehberi"},"content":{"rendered":"

<\/p>\n

Her C# geli\u015ftiricisinin kar\u015f\u0131la\u015ft\u0131\u011f\u0131 bir an vard\u0131r: Taray\u0131c\u0131 geli\u015ftirici ara\u00e7lar\u0131ndan, Postman’den veya bir API dok\u00fcmantasyonundan kopyalanm\u0131\u015f, kusursuz \u00e7al\u0131\u015fan bir CURL komutu. Ancak bu komutu C# koduna d\u00f6n\u00fc\u015ft\u00fcrmek, genellikle ba\u015flang\u0131\u00e7ta g\u00f6r\u00fcnd\u00fc\u011f\u00fcnden daha karma\u015f\u0131k bir s\u00fcre\u00e7tir ve bir\u00e7ok geli\u015ftirici i\u00e7in bir \u201ckopyala-yap\u0131\u015ft\u0131r\u201d \u00e7\u0131kmaz\u0131na d\u00f6n\u00fc\u015febilir. Bu makale, CURL komutlar\u0131n\u0131n ard\u0131ndaki mant\u0131\u011f\u0131 anlaman\u0131za, bu komutlar\u0131 g\u00fcvenle modern C# uygulamalar\u0131na ta\u015f\u0131man\u0131za ve HTTP isteklerinizi daha etkin bir \u015fekilde y\u00f6netmenize yard\u0131mc\u0131 olacak kapsaml\u0131 bir rehber sunmaktad\u0131r.<\/p>\n

Bir C# geli\u015ftiricisi olarak, web servisleriyle entegrasyon yapmak g\u00fcnl\u00fck i\u015flerinizin \u00f6nemli bir par\u00e7as\u0131d\u0131r. Gerek kendi yazd\u0131\u011f\u0131n\u0131z REST API’leri test etmek, gerek \u00fc\u00e7\u00fcnc\u00fc taraf servislerle (\u00f6deme a\u011f ge\u00e7itleri, sosyal medya API’leri, bulut servisleri vb.) ileti\u015fim kurmak olsun, HTTP istekleri ka\u00e7\u0131n\u0131lmazd\u0131r. Bu s\u00fcre\u00e7te, API dok\u00fcmantasyonlar\u0131 veya hata ay\u0131klama ara\u00e7lar\u0131 genellikle size \u00f6rnek olarak bir CURL komutu sunar. CURL, komut sat\u0131r\u0131ndan URL’ler arac\u0131l\u0131\u011f\u0131yla veri aktar\u0131m\u0131 yapmak i\u00e7in kullan\u0131lan g\u00fc\u00e7l\u00fc ve evrensel bir ara\u00e7t\u0131r. Basit s\u00f6zdizimi, esnekli\u011fi ve hemen hemen her i\u015fletim sisteminde bulunmas\u0131 sayesinde, bir API’nin h\u0131zl\u0131ca test edilmesi, do\u011frulama yap\u0131lmas\u0131 veya bir senaryonun provas\u0131 i\u00e7in vazge\u00e7ilmezdir. Peki, bu kadar kullan\u0131\u015fl\u0131 bir arac\u0131n komutlar\u0131n\u0131 C# ortam\u0131na aktarmak neden bu kadar zorlu bir deneyim haline geliyor?<\/p>\n

Sorun, CURL’\u0131n basitli\u011finde ve esnekli\u011finde yat\u0131yor olabilir. Bir CURL komutu tek bir sat\u0131rda HTTP metodunu, URL’yi, ba\u015fl\u0131klar\u0131, g\u00f6vdeyi ve hatta kimlik do\u011frulama bilgilerini bar\u0131nd\u0131rabilir. \u00d6rne\u011fin, bir API \u00e7a\u011fr\u0131s\u0131 s\u0131ras\u0131nda kar\u015f\u0131la\u015ft\u0131\u011f\u0131n\u0131z bir sorunu h\u0131zla test etmek istedi\u011finizde, taray\u0131c\u0131n\u0131z\u0131n geli\u015ftirici ara\u00e7lar\u0131ndaki a\u011f sekmesinden bir CURL komutu kopyalay\u0131p terminalinize yap\u0131\u015ft\u0131r\u0131r, birka\u00e7 parametre de\u011fi\u015ftirir ve an\u0131nda yan\u0131t\u0131 g\u00f6r\u00fcrs\u00fcn\u00fcz. Bu h\u0131zl\u0131 geri bildirim d\u00f6ng\u00fcs\u00fc paha bi\u00e7ilmezdir. Ancak, ayn\u0131 i\u015flemi C# kodunda yapmak istedi\u011finizde, bu tek sat\u0131rl\u0131k komutun ard\u0131ndaki t\u00fcm detaylar\u0131 ayr\u0131\u015ft\u0131rman\u0131z, her bir HTTP ba\u015fl\u0131\u011f\u0131n\u0131 ayr\u0131 ayr\u0131 tan\u0131mlaman\u0131z, istek g\u00f6vdesini do\u011fru formatta seri hale getirmeniz ve asenkron programlaman\u0131n inceliklerini g\u00f6z \u00f6n\u00fcnde bulundurman\u0131z gerekir. Bu \u00e7eviri s\u00fcreci, \u00f6zellikle HTTP protokol\u00fcne veya C#\u2019\u0131n HttpClient<\/code> s\u0131n\u0131f\u0131na tam anlam\u0131yla hakim olmayan geli\u015ftiriciler i\u00e7in kafa kar\u0131\u015ft\u0131r\u0131c\u0131 ve zaman al\u0131c\u0131 olabilir. CURL\u2019\u0131n sundu\u011fu her k\u0131sa yol veya varsay\u0131lan davran\u0131\u015f, C# taraf\u0131nda bilin\u00e7li bir se\u00e7im veya spesifik bir kod sat\u0131r\u0131 gerektirebilir. Bu makalede, bu bo\u015flu\u011fu kapatarak, CURL komutlar\u0131n\u0131n C# kar\u015f\u0131l\u0131klar\u0131n\u0131 ad\u0131m ad\u0131m nas\u0131l olu\u015fturaca\u011f\u0131n\u0131z\u0131 ve modern .NET uygulamalar\u0131n\u0131zda g\u00fc\u00e7l\u00fc, hataya dayan\u0131kl\u0131 ve okunabilir HTTP istemcileri nas\u0131l yazaca\u011f\u0131n\u0131z\u0131 ke\u015ffedece\u011fiz. Art\u0131k CURL komutlar\u0131n\u0131 sadece test arac\u0131 olarak de\u011fil, ayn\u0131 zamanda C# entegrasyonlar\u0131n\u0131z i\u00e7in de\u011ferli bir ba\u015flang\u0131\u00e7 noktas\u0131 olarak g\u00f6receksiniz. Bu d\u00f6n\u00fc\u015f\u00fcmle birlikte, API entegrasyon s\u00fcre\u00e7lerinizdeki verimlili\u011finizin ve hata ay\u0131klama yeteneklerinizin \u00f6nemli \u00f6l\u00e7\u00fcde artaca\u011f\u0131ndan emin olabilirsiniz.<\/p>\n

CURL Komutlar\u0131n\u0131n Derinlemesine Analizi: HTTP \u0130steklerine Nas\u0131l \u00c7evrilirler?<\/h2>\n

CURL komutlar\u0131n\u0131 C# koduna ba\u015far\u0131yla \u00e7evirmenin anahtar\u0131, \u00f6ncelikle CURL’\u0131n nas\u0131l \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 ve bir HTTP iste\u011finin temel bile\u015fenlerini komut sat\u0131r\u0131nda nas\u0131l ifade etti\u011fini tam olarak anlamaktan ge\u00e7er. Her CURL komutu, nihayetinde bir HTTP iste\u011fine d\u00f6n\u00fc\u015fen belirli talimatlar\u0131 i\u00e7erir. Bu talimatlar\u0131 ayr\u0131\u015ft\u0131rmak, C# taraf\u0131nda hangi HttpClient<\/code> metotlar\u0131n\u0131 ve \u00f6zelliklerini kullanman\u0131z gerekti\u011fini belirlemenize yard\u0131mc\u0131 olacakt\u0131r. \u015eimdi, en yayg\u0131n CURL bayraklar\u0131n\u0131 ve bunlar\u0131n HTTP\/C# kar\u015f\u0131l\u0131klar\u0131n\u0131 inceleyelim.<\/p>\n

Temel CURL Bayraklar\u0131 ve HTTP Kar\u015f\u0131l\u0131klar\u0131 Nelerdir?<\/h3>\n

Bir CURL komutunun temel yap\u0131s\u0131 genellikle a\u015fa\u011f\u0131daki \u00f6\u011feleri i\u00e7erir:<\/p>\n

\ncurl [URL] [bayraklar]\n<\/pre>\n
<\/code><\/p>\n
Bu yap\u0131y\u0131 olu\u015fturan ve en s\u0131k kullan\u0131lan bayraklara odaklanal\u0131m:<\/p>\n
    \n
  • -X <\/code> veya --request <\/code>: HTTP Metodu (GET, POST, PUT, DELETE vb.)<\/strong>\n
      \n
    • Bu bayrak, iste\u011fin HTTP metodunu a\u00e7\u0131k\u00e7a belirtir. E\u011fer belirtilmezse ve -d<\/code> veya --data<\/code> bayraklar\u0131 kullan\u0131l\u0131yorsa varsay\u0131lan olarak POST, aksi takdirde GET olur.<\/li>\n
    • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> HttpMethod.Get<\/code>, HttpMethod.Post<\/code>, HttpMethod.Put<\/code>, HttpMethod.Delete<\/code> gibi HttpMethod<\/code> enum de\u011ferleriyle veya new HttpRequestMessage(new HttpMethod(\"CUSTOM\"), uri)<\/code> ile \u00f6zel metotlar tan\u0131mlanabilir.<\/li>\n<\/ul>\n<\/li>\n
    • -H \": \"<\/code> veya --header \": \"<\/code>: \u0130stek Ba\u015fl\u0131klar\u0131<\/strong>\n
        \n
      • Bu bayrak, HTTP iste\u011fine \u00f6zel ba\u015fl\u0131klar eklemek i\u00e7in kullan\u0131l\u0131r. Genellikle Content-Type<\/code>, Authorization<\/code>, User-Agent<\/code> gibi bilgiler bu yolla g\u00f6nderilir. Birden fazla ba\u015fl\u0131k i\u00e7in birden fazla -H<\/code> bayra\u011f\u0131 kullan\u0131labilir.<\/li>\n
      • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> HttpClient.DefaultRequestHeaders.Add(\"Header-Name\", \"Header-Value\")<\/code> veya HttpRequestMessage.Headers.Add(\"Header-Name\", \"Header-Value\")<\/code> metotlar\u0131 ile y\u00f6netilir. \u0130\u00e7erik tipi i\u00e7in request.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application\/json\")<\/code> gibi \u00f6zel y\u00f6ntemler de kullan\u0131l\u0131r.<\/li>\n<\/ul>\n<\/li>\n
      • -d ''<\/code> veya --data ''<\/code>: \u0130stek G\u00f6vdesi (Body)<\/strong>\n
          \n
        • Bu bayrak, POST, PUT gibi metotlarla sunucuya g\u00f6nderilecek veriyi belirtir. Genellikle JSON veya form verileri bu yolla g\u00f6nderilir. Tek t\u0131rnaklar ('<\/code>) i\u00e7indeki veri genellikle dize olarak yorumlan\u0131r.<\/li>\n
        • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> StringContent<\/code>, JsonContent<\/code> (modern .NET), FormUrlEncodedContent<\/code> veya MultipartFormDataContent<\/code> gibi HttpContent<\/code> t\u00fcrevleri kullan\u0131larak istek g\u00f6vdesi olu\u015fturulur ve HttpRequestMessage.Content<\/code> \u00f6zelli\u011fine atan\u0131r.<\/li>\n<\/ul>\n<\/li>\n
        • -u :<\/code> veya --user :<\/code>: Temel Kimlik Do\u011frulama (Basic Auth)<\/strong>\n
            \n
          • Bu bayrak, HTTP Basic Authentication i\u00e7in kullan\u0131c\u0131 ad\u0131 ve \u015fifreyi do\u011frudan belirtmenizi sa\u011flar. CURL bu bilgileri Base64 kodlu bir Authorization<\/code> ba\u015fl\u0131\u011f\u0131na d\u00f6n\u00fc\u015ft\u00fcr\u00fcr.<\/li>\n
          • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> HttpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(Encoding.ASCII.GetBytes($\"{username}:{password}\")))<\/code> \u015feklinde veya HttpRequestMessage<\/code> \u00fczerinde benzer bir kullan\u0131m.<\/li>\n<\/ul>\n<\/li>\n
          • -k<\/code> veya --insecure<\/code>: SSL Sertifikas\u0131 Do\u011frulamas\u0131n\u0131 Devre D\u0131\u015f\u0131 B\u0131rak<\/strong>\n
              \n
            • Bu bayrak, HTTPS ba\u011flant\u0131lar\u0131nda sunucu sertifikas\u0131 do\u011frulamas\u0131n\u0131 yoksayman\u0131z\u0131 sa\u011flar. Genellikle geli\u015ftirme ortamlar\u0131nda veya testlerde kullan\u0131l\u0131r.<\/li>\n
            • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> HttpClientHandler<\/code> s\u0131n\u0131f\u0131n\u0131n ServerCertificateCustomValidationCallback<\/code> \u00f6zelli\u011fi veya DangerousAcceptAnyServerCertificateValidator<\/code> gibi se\u00e7eneklerle y\u00f6netilir. \u00dcretim ortamlar\u0131nda bu dikkatli kullan\u0131lmal\u0131d\u0131r.<\/li>\n<\/ul>\n<\/li>\n
            • --compressed<\/code>: S\u0131k\u0131\u015ft\u0131rmay\u0131 Kabul Et<\/strong>\n
                \n
              • Bu bayrak, CURL'\u0131n sunucuya Accept-Encoding: deflate, gzip<\/code> ba\u015fl\u0131\u011f\u0131 g\u00f6ndermesini sa\u011flar, b\u00f6ylece s\u0131k\u0131\u015ft\u0131r\u0131lm\u0131\u015f yan\u0131tlar\u0131 kabul edebilir.<\/li>\n
              • C# Kar\u015f\u0131l\u0131\u011f\u0131:<\/strong> HttpClientHandler.AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate;<\/code> ile otomatik olarak sa\u011flan\u0131r.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                \n    Uzman \u0130pucu: Bir CURL komutunu kopyalad\u0131\u011f\u0131n\u0131zda, onu \u00f6nce bir metin d\u00fczenleyiciye yap\u0131\u015ft\u0131r\u0131p her bir bayra\u011f\u0131 ve de\u011ferini ayr\u0131 sat\u0131rlara b\u00f6lerek daha kolay analiz edebilirsiniz. Bu, hangi b\u00f6l\u00fcm\u00fcn HTTP metodu, hangi b\u00f6l\u00fcm\u00fcn ba\u015fl\u0131k, hangi b\u00f6l\u00fcm\u00fcn g\u00f6vde oldu\u011funu net bir \u015fekilde g\u00f6rmenize yard\u0131mc\u0131 olur. Ayr\u0131ca, API dok\u00fcmantasyonlar\u0131ndaki \u00f6rnek CURL komutlar\u0131 genellikle ideal senaryoyu yans\u0131t\u0131r; kendi uygulamalar\u0131n\u0131zda a\u011f hatalar\u0131, zaman a\u015f\u0131mlar\u0131 ve sunucu yan\u0131tlar\u0131n\u0131 ele almak i\u00e7in daha sa\u011flam kod yazman\u0131z gerekecektir.\n<\/div>\n
                Bu temel bayraklar\u0131 ve onlar\u0131n C#\u2019taki kar\u015f\u0131l\u0131klar\u0131n\u0131 anlad\u0131\u011f\u0131n\u0131zda, herhangi bir CURL komutunu C# koduna \u00e7evirme s\u00fcreci \u00e7ok daha y\u00f6netilebilir hale gelecektir. Art\u0131k bu teorik bilgiyi pratik uygulamalara d\u00f6kelim ve modern C# ile HttpClient<\/code> kullan\u0131m\u0131na ge\u00e7elim.<\/p>\n
                Modern C# ile HTTP \u0130stekleri: HttpClient<\/code> Nas\u0131l Kullan\u0131l\u0131r?<\/h2>\n
                C# dilinde HTTP istekleri yapmak i\u00e7in birka\u00e7 farkl\u0131 yol bulunur, ancak modern .NET uygulamalar\u0131nda kesinlikle tercih edilmesi gereken ana ara\u00e7 HttpClient<\/code> s\u0131n\u0131f\u0131d\u0131r. Bir zamanlar pop\u00fcler olan WebClient<\/code>, daha basit senaryolar i\u00e7in yeterli olsa da, asenkron i\u015flemler, ba\u011flant\u0131 y\u00f6netimi, hata i\u015fleme ve test edilebilirlik a\u00e7\u0131s\u0131ndan HttpClient<\/code>'\u0131n sundu\u011fu esneklik ve g\u00fc\u00e7le k\u0131yaslanamaz. HttpClient<\/code>, System.Net.Http<\/code> ad alan\u0131 alt\u0131nda bulunur ve HTTP\/1.1, HTTP\/2 (ve gelecekte HTTP\/3) protokollerini destekleyerek web servisleriyle etkile\u015fim kurmak i\u00e7in sa\u011flam ve performansl\u0131 bir temel sa\u011flar.<\/p>\n
                Basit GET \u0130stekleri ve Parametre Y\u00f6netimi Nas\u0131l Yap\u0131l\u0131r?<\/h3>\n
                Bir CURL GET iste\u011fini C# diline \u00e7evirmek olduk\u00e7a basittir. \u00d6rne\u011fin, curl https:\/\/jsonplaceholder.typicode.com\/posts\/1<\/code> komutunu ele alal\u0131m. Bu komut, belirtilen URL'den bir JSON kayna\u011f\u0131 \u00e7ekecektir. C# taraf\u0131nda bu i\u015flemi nas\u0131l ger\u00e7ekle\u015ftiririz:<\/p>\n
                \nusing System;\nusing System.Net.Http;\nusing System.Threading.Tasks;\n\npublic class BasicGetExample\n{\n    public static async Task RunGetRequest()\n    {\n        \/\/ HttpClient \u00f6rne\u011fini olu\u015fturuyoruz.\n        \/\/ Genellikle HttpClientFactory kullanarak y\u00f6netilmesi \u00f6nerilir.\n        \/\/ Tekil bir \u00f6rnek (Singleton) olarak kullan\u0131lmas\u0131 performans a\u00e7\u0131s\u0131ndan \u00f6nemlidir.\n        \/\/ Daha detayl\u0131 bilgi ilerleyen b\u00f6l\u00fcmlerde verilecektir.\n        using (HttpClient client = new HttpClient())\n        {\n            string requestUri = \"https:\/\/jsonplaceholder.typicode.com\/posts\/1\";\n\n            try\n            {\n                \/\/ GET iste\u011fi g\u00f6nderiyoruz ve yan\u0131t\u0131 bekliyoruz.\n                HttpResponseMessage response = await client.GetAsync(requestUri);\n\n                \/\/ Yan\u0131t ba\u015far\u0131l\u0131 m\u0131 kontrol ediyoruz (2xx durum kodlar\u0131).\n                response.EnsureSuccessStatusCode(); \/\/ Ba\u015far\u0131s\u0131z olursa exception f\u0131rlat\u0131r.\n\n                \/\/ Yan\u0131t i\u00e7eri\u011fini dize olarak okuyoruz.\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"GET iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"GET iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n            catch (Exception e)\n            {\n                Console.WriteLine($\"Beklenmeyen bir hata olu\u015ftu: {e.Message}\");\n            }\n        }\n    }\n\n    public static async Task RunGetRequestWithParameters()\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            \/\/ Parametreleri URI'ye eklemek i\u00e7in UriBuilder veya QueryHelpers kullanabilirsiniz.\n            \/\/ \u00d6rne\u011fin: curl \"https:\/\/jsonplaceholder.typicode.com\/posts?userId=1&_limit=5\"\n            UriBuilder uriBuilder = new UriBuilder(\"https:\/\/jsonplaceholder.typicode.com\/posts\");\n            var query = System.Web.HttpUtility.ParseQueryString(uriBuilder.Query);\n            query[\"userId\"] = \"1\";\n            query[\"_limit\"] = \"5\";\n            uriBuilder.Query = query.ToString();\n\n            string requestUri = uriBuilder.ToString();\n\n            try\n            {\n                HttpResponseMessage response = await client.GetAsync(requestUri);\n                response.EnsureSuccessStatusCode();\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"Parametreli GET iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"Parametreli GET iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n        }\n    }\n}\n<\/pre>\n
                <\/code><\/p>\n
                Yukar\u0131daki \u00f6rnekte, client.GetAsync()<\/code> metodu asenkron olarak GET iste\u011fini g\u00f6nderir. EnsureSuccessStatusCode()<\/code>, HTTP yan\u0131t\u0131n\u0131n ba\u015far\u0131l\u0131 bir durum koduna (2xx) sahip olup olmad\u0131\u011f\u0131n\u0131 kontrol eder. De\u011filse, bir HttpRequestException<\/code> f\u0131rlat\u0131r. ReadAsStringAsync()<\/code> ise yan\u0131t g\u00f6vdesini dize olarak okur.<\/p>\n
                JSON Verileriyle POST ve PUT \u0130stekleri Nas\u0131l G\u00f6nderilir?<\/h3>\n
                POST ve PUT gibi metotlar, istek g\u00f6vdesinde veri g\u00f6ndermeyi gerektirir. CURL'da bu genellikle -d<\/code> veya --data<\/code> bayra\u011f\u0131 ile yap\u0131l\u0131r. \u00d6rne\u011fin: curl -X POST -H \"Content-Type: application\/json\" -d '{\"title\": \"foo\", \"body\": \"bar\", \"userId\": 1}' https:\/\/jsonplaceholder.typicode.com\/posts<\/code><\/p>\n
                Bu CURL komutunu C# ile nas\u0131l uygulayaca\u011f\u0131m\u0131za bakal\u0131m:<\/p>\n
                \nusing System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\nusing System.Text.Json; \/\/ JSON serile\u015ftirme i\u00e7in\n\npublic class PostPutExample\n{\n    public static async Task RunPostRequest()\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            string requestUri = \"https:\/\/jsonplaceholder.typicode.com\/posts\";\n\n            \/\/ POST edilecek veri\n            var postData = new \n            { \n                title = \"foo\", \n                body = \"bar\", \n                userId = 1 \n            };\n            \n            \/\/ Veriyi JSON string'ine \u00e7eviriyoruz\n            string jsonContent = JsonSerializer.Serialize(postData);\n\n            \/\/ StringContent ile istek g\u00f6vdesini olu\u015fturuyoruz\n            \/\/ Content-Type ba\u015fl\u0131\u011f\u0131n\u0131 burada belirtiyoruz\n            StringContent content = new StringContent(jsonContent, Encoding.UTF8, \"application\/json\");\n\n            try\n            {\n                \/\/ POST iste\u011fi g\u00f6nderiyoruz\n                HttpResponseMessage response = await client.PostAsync(requestUri, content);\n                response.EnsureSuccessStatusCode();\n\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"POST iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"POST iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n        }\n    }\n\n    public static async Task RunPutRequest()\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            string requestUri = \"https:\/\/jsonplaceholder.typicode.com\/posts\/1\"; \/\/ G\u00fcncellenecek kaynak\n\n            \/\/ PUT edilecek veri\n            var putData = new \n            { \n                id = 1, \/\/ API genellikle id bekler\n                title = \"foo updated\", \n                body = \"bar updated\", \n                userId = 1 \n            };\n\n            string jsonContent = JsonSerializer.Serialize(putData);\n            StringContent content = new StringContent(jsonContent, Encoding.UTF8, \"application\/json\");\n\n            try\n            {\n                \/\/ PUT iste\u011fi g\u00f6nderiyoruz\n                HttpResponseMessage response = await client.PutAsync(requestUri, content);\n                response.EnsureSuccessStatusCode();\n\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"PUT iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"PUT iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n        }\n    }\n}\n<\/pre>\n
                <\/code><\/p>\n
                Burada kilit nokta, iste\u011fin g\u00f6vdesini temsil eden bir HttpContent<\/code> nesnesi olu\u015fturmakt\u0131r. StringContent<\/code>, metin tabanl\u0131 veriler i\u00e7in idealdir. JSON verileri g\u00f6nderirken System.Text.Json<\/code> veya Newtonsoft.Json gibi k\u00fct\u00fcphanelerle nesneleri JSON dizelerine seri hale getirmeniz gerekmektedir.<\/p>\n
                Kimlik Do\u011frulama Mekanizmalar\u0131n\u0131 C# Koduna Nas\u0131l Entegre Ederiz?<\/h3>\n
                CURL komutlar\u0131nda s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan kimlik do\u011frulama y\u00f6ntemleri Basic Auth (-u<\/code> bayra\u011f\u0131) ve Bearer Token (-H \"Authorization: Bearer ...\"<\/code> ba\u015fl\u0131\u011f\u0131) \u015feklindedir. Bu mekanizmalar\u0131 C#\u2019a \u00e7evirmek olduk\u00e7a basittir.<\/p>\n
                \nusing System;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Text;\nusing System.Threading.Tasks;\n\npublic class AuthenticationExample\n{\n    public static async Task RunBasicAuthRequest()\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            \/\/ CURL \u00f6rne\u011fi: curl -u \"user:password\" https:\/\/api.example.com\/secured-endpoint\n            string username = \"testuser\";\n            string password = \"testpassword\";\n            string authString = $\"{username}:{password}\";\n            \n            \/\/ Base64 kodlu string olu\u015fturma\n            string base64AuthString = Convert.ToBase64String(Encoding.ASCII.GetBytes(authString));\n\n            \/\/ Authorization ba\u015fl\u0131\u011f\u0131n\u0131 ekliyoruz\n            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Basic\", base64AuthString);\n\n            string requestUri = \"https:\/\/jsonplaceholder.typicode.com\/posts\"; \/\/ G\u00fcvenli bir endpoint olmad\u0131\u011f\u0131n\u0131 varsayal\u0131m, sadece ba\u015fl\u0131k eklemeyi g\u00f6steriyoruz.\n\n            try\n            {\n                HttpResponseMessage response = await client.GetAsync(requestUri);\n                response.EnsureSuccessStatusCode();\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"Basic Auth iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"Basic Auth iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n        }\n    }\n\n    public static async Task RunBearerTokenRequest()\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            \/\/ CURL \u00f6rne\u011fi: curl -H \"Authorization: Bearer your_jwt_token\" https:\/\/api.example.com\/secured-endpoint\n            string bearerToken = \"your_jwt_token_here\"; \/\/ Ger\u00e7ek bir JWT tokeni ile de\u011fi\u015ftirin\n\n            \/\/ Authorization ba\u015fl\u0131\u011f\u0131n\u0131 ekliyoruz\n            client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(\"Bearer\", bearerToken);\n\n            string requestUri = \"https:\/\/jsonplaceholder.typicode.com\/posts\"; \/\/ G\u00fcvenli bir endpoint olmad\u0131\u011f\u0131n\u0131 varsayal\u0131m.\n\n            try\n            {\n                HttpResponseMessage response = await client.GetAsync(requestUri);\n                response.EnsureSuccessStatusCode();\n                string responseBody = await response.Content.ReadAsStringAsync();\n                Console.WriteLine($\"Bearer Token iste\u011fi ba\u015far\u0131l\u0131: \\n{responseBody}\");\n            }\n            catch (HttpRequestException e)\n            {\n                Console.WriteLine($\"Bearer Token iste\u011fi ba\u015far\u0131s\u0131z: {e.Message}\");\n            }\n        }\n    }\n}\n<\/pre>\n
                <\/code><\/p>\n
                Her iki durumda da, HttpClient.DefaultRequestHeaders.Authorization<\/code> \u00f6zelli\u011fini kullanarak AuthenticationHeaderValue<\/code> nesnesi olu\u015fturulur. Bu, t\u00fcm sonraki istekler i\u00e7in bu kimlik do\u011frulama bilgisini otomatik olarak ekleyecektir. Belirli bir istek i\u00e7in farkl\u0131 kimlik do\u011frulama gerekiyorsa, bu ba\u015fl\u0131klar\u0131 HttpRequestMessage.Headers<\/code> koleksiyonuna ekleyebilirsiniz. Bu y\u00f6ntemlerle, C# uygulamalar\u0131n\u0131zda g\u00fc\u00e7l\u00fc ve \u00e7e\u015fitli kimlik do\u011frulama mekanizmalar\u0131n\u0131 kolayca uygulayabilirsiniz.<\/p>\n
                Karma\u015f\u0131k Senaryolar ve Geli\u015fmi\u015f HttpClient<\/code> Kullan\u0131m\u0131: Performans ve G\u00fcvenlik<\/h2>\n
                Temel GET, POST ve PUT isteklerinin \u00f6tesinde, ger\u00e7ek d\u00fcnya senaryolar\u0131nda daha karma\u015f\u0131k CURL komutlar\u0131yla kar\u015f\u0131la\u015fmak m\u00fcmk\u00fcnd\u00fcr. Dosya y\u00fcklemeleri, \u00f6zel i\u00e7erik t\u00fcrleri, proxy ayarlar\u0131 veya sertifika do\u011frulama bypasslar\u0131 gibi durumlar, HttpClient<\/code>'\u0131n daha geli\u015fmi\u015f \u00f6zelliklerini kullanmay\u0131 gerektirir. Bu b\u00f6l\u00fcmde, bu ileri d\u00fczey senaryolar\u0131 ele alacak ve HttpClient<\/code>'\u0131n performans ve g\u00fcvenlik odakl\u0131 kullan\u0131m ipu\u00e7lar\u0131n\u0131 inceleyece\u011fiz.<\/p>\n
                Dosya Y\u00fcklemeleri ve Form Verileriyle Nas\u0131l Ba\u015fa \u00c7\u0131k\u0131l\u0131r?<\/h3>\n
                CURL'da dosya y\u00fcklemek veya multipart\/form-data ile veri g\u00f6ndermek i\u00e7in -F<\/code> veya --form<\/code> bayra\u011f\u0131 kullan\u0131l\u0131r. \u00d6rne\u011fin: curl -X POST -F \"file=@\/path\/to\/your\/file.txt\" -F \"description=My file\" https:\/\/api.example.com\/upload<\/code>. C#\u2019ta bu senaryoyu MultipartFormDataContent<\/code> s\u0131n\u0131f\u0131 ile y\u00f6netiriz:<\/p>\n
                \nusing System;\nusing System.IO;\nusing System.Net.Http;\nusing System.Threading.Tasks;\n\npublic class FileUploadExample\n{\n    public static async Task RunFileUploadRequest(string filePath)\n    {\n        using (HttpClient client = new HttpClient())\n        {\n            string requestUri = \"https:\/\/api.example.com\/upload\"; \/\/ Ger\u00e7ek bir y\u00fckleme endpoint'i ile de\u011fi\u015ftirin\n\n            using (MultipartFormDataContent formData = new MultipartFormDataContent())\n            {\n                \/\/ Dosya i\u00e7eri\u011fini ekliyoruz\n                using (FileStream fileStream = File.OpenRead(filePath))\n                {\n                    StreamContent fileContent = new StreamContent(fileStream);\n                    fileContent.Headers.ContentDisposition = new System.Net.Http.Headers.ContentDispositionHeaderValue(\"form-data\")\n                    {\n                        Name = \"\\\"file\\\"\",\n                        FileName = $\"\\\"{Path.GetFileName(filePath)}\\\"\"\n                    };\n                    formData.Add(fileContent, \"file\", Path.GetFileName(filePath));\n                }\n\n                \/\/ Di\u011fer form alanlar\u0131n\u0131 ekliyoruz (\u00f6rn. \"description\")\n                formData.Add(new StringContent(\"My file description\"), \"description\");\n\n                try\n                {\n                    HttpResponseMessage response = await client.PostAsync(requestUri, formData);\n                    response.EnsureSuccessStatusCode();\n\n                    string responseBody = await response.Content.ReadAsStringAsync();\n                    Console.WriteLine($\"Dosya y\u00fckleme ba\u015far\u0131l\u0131: \\n{responseBody}\");\n                }\n                catch (HttpRequestException e)\n                {\n                    Console.WriteLine($\"Dosya y\u00fckleme ba\u015far\u0131s\u0131z: {e.Message}\");\n                }\n            }\n        }\n    }\n}\n<\/pre>\n
                <\/code><\/p>\n
                MultipartFormDataContent<\/code>, her bir form alan\u0131n\u0131 (dosya veya metin) ayr\u0131 ayr\u0131 eklemenizi sa\u011flar. Dosya eklerken StreamContent<\/code> kullanmak ve do\u011fru ContentDispositionHeaderValue<\/code> ayarlamak \u00f6nemlidir.<\/p>\n
                HttpClientFactory<\/code> ile Kaynak Y\u00f6netimi ve \u0130yile\u015ftirme Nas\u0131l Sa\u011flan\u0131r?<\/h3>\n
                Do\u011frudan new HttpClient()<\/code> kullanarak olu\u015fturulan HttpClient<\/code> \u00f6rnekleri, baz\u0131 \u00f6nemli sorunlara yol a\u00e7abilir:<\/p>\n
                  \n
                • Soket Yorgunlu\u011fu (Socket Exhaustion):<\/strong> Her HttpClient<\/code> \u00f6rne\u011fi, arkas\u0131nda bir TCP ba\u011flant\u0131s\u0131 tutabilir. \u00c7ok say\u0131da HttpClient<\/code> \u00f6rne\u011fi olu\u015fturup atmak, ba\u011flant\u0131 noktalar\u0131n\u0131n h\u0131zla t\u00fckenmesine neden olabilir.<\/li>\n
                • DNS De\u011fi\u015fikliklerinin Yans\u0131t\u0131lamamas\u0131:<\/strong> HttpClient<\/code> \u00f6rnekleri DNS \u00f6nbelle\u011fini varsay\u0131lan olarak tutar. Uzun \u00f6m\u00fcrl\u00fc tek bir HttpClient<\/code> \u00f6rne\u011fi kullan\u0131ld\u0131\u011f\u0131nda, hedef sunucunun IP adresi de\u011fi\u015fse bile uygulaman\u0131z eski adrese istek g\u00f6ndermeye devam edebilir.<\/li>\n<\/ul>\n
                  Bu sorunlar\u0131 \u00e7\u00f6zmek i\u00e7in .NET Core ve .NET 5+ ile gelen IHttpClientFactory<\/code> kullan\u0131lmas\u0131 \u015fiddetle tavsiye edilir. HttpClientFactory<\/code>, HttpClient<\/code> \u00f6rneklerini do\u011fru bir \u015fekilde y\u00f6netir, yeniden kullan\u0131r ve \u00f6m\u00fcrlerini optimize eder.<\/p>\n
                  \n\/\/ Startup.cs (veya Program.cs) i\u00e7inde yap\u0131land\u0131rma\npublic void ConfigureServices(IServiceCollection services)\n{\n    \/\/ Adland\u0131r\u0131lm\u0131\u015f bir HttpClient \u00f6rne\u011fi kaydetme\n    services.AddHttpClient(\"MyApiService\", client =>\n    {\n        client.BaseAddress = new Uri(\"https:\/\/api.example.com\/\");\n        client.DefaultRequestHeaders.Add(\"Accept\", \"application\/json\");\n        \/\/ Di\u011fer varsay\u0131lan ayarlar...\n    })\n    \/\/ G\u00fcvenlik a\u00e7\u0131s\u0131ndan sertifika do\u011frulamas\u0131n\u0131 devre d\u0131\u015f\u0131 b\u0131rakmak i\u00e7in bir \u00f6rnek (\u00dcretimde KULLANMAYIN!)\n    .ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler\n    {\n        ServerCertificateCustomValidationCallback = (message, cert, chain, errors) => { return true; } \/\/ Sadece test\/dev i\u00e7in\n    });\n\n    \/\/ Yaz\u0131l\u0131 (Typed) bir HttpClient \u00f6rne\u011fi kaydetme\n    services.AddHttpClient();\n}\n\n\/\/ Uygulama i\u00e7inde kullan\u0131m\npublic class MyService\n{\n    private readonly HttpClient _httpClient;\n\n    public MyService(IHttpClientFactory httpClientFactory)\n    {\n        \/\/ Adland\u0131r\u0131lm\u0131\u015f istemciyi alma\n        _httpClient = httpClientFactory.CreateClient(\"MyApiService\");\n\n        \/\/ veya yaz\u0131l\u0131 istemci kullan\u0131yorsan\u0131z do\u011frudan MyTypedClient enjekte edilir.\n        \/\/ public MyService(MyTypedClient client) { _httpClient = client.HttpClient; }\n    }\n\n    public async Task GetData()\n    {\n        \/\/ _httpClient, HttpClientFactory taraf\u0131ndan y\u00f6netilen bir \u00f6rnektir.\n        \/\/ Do\u011fru \u00f6m\u00fcrle ve ba\u011flant\u0131 havuzu ile gelir.\n        return await _httpClient.GetStringAsync(\"data\");\n    }\n}\n\n\/\/ Yaz\u0131l\u0131 istemci \u00f6rne\u011fi\npublic class MyTypedClient\n{\n    public HttpClient HttpClient { get; }\n\n    public MyTypedClient(HttpClient httpClient)\n    {\n        HttpClient = httpClient;\n        HttpClient.BaseAddress = new Uri(\"https:\/\/api.example.com\/\");\n        HttpClient.DefaultRequestHeaders.Add(\"User-Agent\", \"MyTypedClient\");\n    }\n\n    public async Task GetSomething()\n    {\n        return await HttpClient.GetStringAsync(\"something\");\n    }\n}\n<\/pre>\n
                  <\/code><\/p>\n
                  \n    Uzman \u0130pucu: HttpClientFactory<\/code> kullanmak, hem performans hem de kaynak y\u00f6netimi a\u00e7\u0131s\u0131ndan kritik \u00f6neme sahiptir. \u00d6zellikle y\u00fcksek y\u00fck alt\u0131ndaki uygulamalarda soket yorgunlu\u011fu gibi sorunlar\u0131 \u00f6nler.\n<\/div>\n
                  Hata Ay\u0131klama, Zaman A\u015f\u0131m\u0131 ve G\u00fcvenlik \u0130pu\u00e7lar\u0131 Nelerdir?<\/h3>\n
                    \n
                  • Hata Ay\u0131klama:<\/strong>\n
                      \n
                    • Fiddler\/Wireshark:<\/strong> CURL komutunuzla ayn\u0131 ortamda Fiddler gibi bir ara\u00e7 kullanarak HTTP trafi\u011fini incelemek, CURL'\u0131n ger\u00e7ekten ne g\u00f6nderdi\u011fini ve API'nin ne yan\u0131t verdi\u011fini g\u00f6rmenizi sa\u011flar. Ard\u0131ndan C# kodunuzun benzer \u00e7\u0131kt\u0131lar \u00fcretip \u00fcretmedi\u011fini kar\u015f\u0131la\u015ft\u0131rabilirsiniz.<\/li>\n
                    • HttpClient<\/code> Logging:<\/strong> \u0130stek ve yan\u0131tlar\u0131 kaydetmek i\u00e7in \u00f6zel bir DelegatingHandler<\/code> kullanabilirsiniz. Bu, \u00f6zellikle karma\u015f\u0131k API entegrasyonlar\u0131nda hata ay\u0131klama i\u00e7in \u00e7ok de\u011ferlidir.<\/li>\n
                      \npublic class LoggingHandler : DelegatingHandler\n{\n    private readonly ILogger _logger;\n\n    public LoggingHandler(ILogger logger) : base(new HttpClientHandler())\n    {\n        _logger = logger;\n    }\n\n    protected override async Task SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)\n    {\n        _logger.LogInformation($\"Request: {request.Method} {request.RequestUri}\");\n        _logger.LogInformation($\"Headers: {request.Headers}\");\n        if (request.Content != null)\n        {\n            _logger.LogInformation($\"Content: {await request.Content.ReadAsStringAsync()}\");\n        }\n\n        HttpResponseMessage response = await base.SendAsync(request, cancellationToken);\n\n        _logger.LogInformation($\"Response: {response.StatusCode}\");\n        _logger.LogInformation($\"Response Headers: {response.Headers}\");\n        if (response.Content != null)\n        {\n            _logger.LogInformation($\"Response Content: {await response.Content.ReadAsStringAsync()}\");\n        }\n\n        return response;\n    }\n}\n\/\/ HttpClientFactory ile kaydederken:\n\/\/ services.AddHttpClient(\"MyApiService\").AddHttpMessageHandler();\n            <\/pre>\n
                      <\/code>\n        <\/ul>\n<\/li>\n
                    • Zaman A\u015f\u0131m\u0131 (Timeout):<\/strong> A\u011f gecikmeleri veya yava\u015f API'ler uygulaman\u0131z\u0131n tak\u0131lmas\u0131na neden olabilir. HttpClient.Timeout<\/code> \u00f6zelli\u011fini kullanarak bir istek i\u00e7in maksimum bekleme s\u00fcresi belirleyebilirsiniz.\n
                      \nusing (HttpClient client = new HttpClient())\n{\n    client.Timeout = TimeSpan.FromSeconds(30); \/\/ 30 saniye sonra zaman a\u015f\u0131m\u0131\n    \/\/ ...\n}\n        <\/pre>\n
                      <\/code>\n    <\/li>\n
                    • G\u00fcvenlik:<\/strong>\n
                        \n
                      • Sertifika Do\u011frulama:<\/strong> CURL'daki -k<\/code> bayra\u011f\u0131na kar\u015f\u0131l\u0131k gelen ServerCertificateCustomValidationCallback<\/code> \u00f6zelli\u011fini \u00fcretim ortamlar\u0131nda ASLA<\/strong> kullanmay\u0131n. Bu, uygulaman\u0131z\u0131 man-in-the-middle sald\u0131r\u0131lar\u0131na kar\u015f\u0131 savunmas\u0131z hale getirir. Her zaman ge\u00e7erli SSL sertifikalar\u0131n\u0131 do\u011frulay\u0131n.<\/li>\n
                      • API Anahtarlar\u0131 ve Hassas Veriler:<\/strong> API anahtarlar\u0131n\u0131, tokenlar\u0131 veya \u015fifreleri do\u011frudan kod i\u00e7ine g\u00f6mmeyin. \u00c7evre de\u011fi\u015fkenleri, .NET Secret Manager veya g\u00fcvenli bir anahtar kasas\u0131 (Azure Key Vault, HashiCorp Vault) kullanarak y\u00f6netin.<\/li>\n
                      • Rate Limiting:<\/strong> Baz\u0131 API'ler, belirli bir s\u00fcre i\u00e7inde yapabilece\u011finiz istek say\u0131s\u0131n\u0131 s\u0131n\u0131rlar. API yan\u0131tlar\u0131ndaki RateLimit-Remaining<\/code> veya Retry-After<\/code> gibi ba\u015fl\u0131klara dikkat edin ve uygulaman\u0131z\u0131n bu s\u0131n\u0131rlamalara uyacak \u015fekilde istekleri geciktirmesini veya yeniden denemesini sa\u011flay\u0131n (Exponential Backoff algoritmalar\u0131).<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
                        \n    Uzman \u0130pucu: Mobil uygulamalar i\u00e7in mobil uyumlu HTML \u00e7\u0131kt\u0131s\u0131 olu\u015ftururken, CSS media query'lerini kullanarak farkl\u0131 ekran boyutlar\u0131na adaptasyon sa\u011flamak \u00f6nemlidir. Ancak HTTP istemcisi kodu, temelde platformdan ba\u011f\u0131ms\u0131z \u00e7al\u0131\u015f\u0131r ve mobil adaptasyonu genellikle UI katman\u0131nda ger\u00e7ekle\u015fir. \u00d6rne\u011fin, <\/p>\n