{"id":7838,"date":"2024-12-27T15:00:14","date_gmt":"2024-12-27T12:00:14","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/net-core-web-apide-headera-ozel-alanlar-ekleme\/"},"modified":"2024-12-27T15:00:14","modified_gmt":"2024-12-27T12:00:14","slug":"net-core-web-apide-headera-ozel-alanlar-ekleme","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/net-core-web-apide-headera-ozel-alanlar-ekleme\/","title":{"rendered":".NET Core Web API’de Header’a \u00d6zel Alanlar Ekleme"},"content":{"rendered":"

.NET Core Web API’de Header’a \u00d6zel Alanlar Ekleme<\/p>\n

Merhaba, .NET Core Web API geli\u015ftiricileri! Bu yaz\u0131da, .NET Core Web API’lerinizin header’lar\u0131na nas\u0131l \u00f6zel alanlar ekleyece\u011finizi ad\u0131m ad\u0131m a\u00e7\u0131klayaca\u011f\u0131m. Bu \u00f6zellik, uygulaman\u0131z\u0131n farkl\u0131 k\u0131s\u0131mlar\u0131 aras\u0131nda ek veri ta\u015f\u0131mak i\u00e7in olduk\u00e7a kullan\u0131\u015fl\u0131d\u0131r. \u00d6rne\u011fin, kimlik do\u011frulama bilgileri, istek zaman damgas\u0131 veya kullan\u0131c\u0131ya \u00f6zg\u00fc ayarlar gibi verileri header’a ekleyebilirsiniz. Hadi ba\u015flayal\u0131m!<\/p>\n

Neden Header’a \u00d6zel Alanlar Eklemeliyiz?<\/h2>\n

Header’lar, HTTP istekleri ve yan\u0131tlar\u0131 aras\u0131nda meta veri ta\u015f\u0131mak i\u00e7in m\u00fckemmel bir yerdir. Bu sayede, ana veri y\u00fck\u00fcnden ba\u011f\u0131ms\u0131z olarak ek bilgiler iletebiliriz. \u00d6rne\u011fin, bir API’den gelen yan\u0131tta hata kodu veya hata mesaj\u0131 gibi bilgileri header’a ekleyerek, ana veri y\u00fck\u00fcn\u00fcn yap\u0131s\u0131n\u0131 de\u011fi\u015ftirmeden istemci taraf\u0131nda daha kolay hata y\u00f6netimi sa\u011flayabiliriz. Ba\u015fka bir kullan\u0131m senaryosu ise, kimlik do\u011frulama i\u00e7in kullan\u0131lan JWT (JSON Web Token) gibi g\u00fcvenlik tokenlerini header’a eklemektir.<\/p>\n

.NET Core Web API’de Header’a \u00d6zel Alan Ekleme<\/h2>\n

\u0130lk olarak, controller’\u0131n\u0131zda bir HttpResponseMessage nesnesi olu\u015fturman\u0131z gerekiyor. Daha sonra, bu nesnenin Headers \u00f6zelli\u011fi arac\u0131l\u0131\u011f\u0131yla custom header ekleyebilirsiniz. A\u015fa\u011f\u0131daki \u00f6rnekte, “Custom-Header” ad\u0131nda bir header ekleyip, ona “Custom Value” de\u011ferini atayoruz:<\/p>\n

csharp
\nusing System.Net;
\nusing System.Net.Http;
\nusing Microsoft.AspNetCore.Mvc;<\/p>\n

[ApiController]
\n[Route(“[controller]”)]
\npublic class MyController : ControllerBase
\n{
\n [HttpGet]
\n public HttpResponseMessage Get()
\n {
\n var response = new HttpResponseMessage(HttpStatusCode.OK);
\n response.Headers.Add(“Custom-Header”, “Custom Value”);
\n response.Content = new StringContent(“Hello World!”);
\n return response;
\n }
\n}<\/p>\n

Bu kodu \u00e7al\u0131\u015ft\u0131rd\u0131\u011f\u0131n\u0131zda, gelen HTTP yan\u0131t\u0131n\u0131n header’\u0131nda “Custom-Header: Custom Value” g\u00f6receksiniz. Dikkat etmeniz gereken nokta, header isimlerinin b\u00fcy\u00fck\/k\u00fc\u00e7\u00fck harfe duyarl\u0131 olmas\u0131d\u0131r. Yani “custom-header” ile “Custom-Header” farkl\u0131 header’lard\u0131r.<\/p>\n

Alternatif Y\u00f6ntem: IActionResult Kullan\u0131m\u0131<\/h2>\n

HttpResponseMessage kullanmak yerine, IActionResult d\u00f6n\u00fc\u015f tipi kullanarak da header’a \u00f6zel alan ekleyebilirsiniz. Bu y\u00f6ntem daha temiz ve okunabilir bir kod sa\u011flar. A\u015fa\u011f\u0131daki \u00f6rnekte, Ok() metodu ile birlikte HttpContext nesnesini kullanarak header’a de\u011fer ekliyoruz:<\/p>\n

csharp
\nusing Microsoft.AspNetCore.Http;
\nusing Microsoft.AspNetCore.Mvc;<\/p>\n

[ApiController]
\n[Route(“[controller]”)]
\npublic class MyController : ControllerBase
\n{
\n [HttpGet]
\n public IActionResult Get()
\n {
\n HttpContext.Response.Headers.Add(“Custom-Header”, “Custom Value from IActionResult”);
\n return Ok(“Hello World!”);
\n }
\n}<\/p>\n

Bu y\u00f6ntemde de sonu\u00e7 ayn\u0131d\u0131r; gelen HTTP yan\u0131t\u0131nda “Custom-Header” header’\u0131n\u0131 g\u00f6receksiniz. Bu y\u00f6ntem, daha modern ve .NET Core’un \u00f6nerdi\u011fi yakla\u015f\u0131m oldu\u011fundan genellikle tercih edilir.<\/p>\n

Hata Y\u00f6netimi ve G\u00fcvenlik<\/h2>\n

\u00d6zel header’lar eklerken, hata y\u00f6netimi ve g\u00fcvenlik \u00f6nlemlerini g\u00f6z \u00f6n\u00fcnde bulundurman\u0131z \u00f6nemlidir. \u00d6zellikle g\u00fcvenlik a\u00e7\u0131s\u0131ndan hassas verileri header’a eklerken dikkatli olmal\u0131 ve uygun \u015fifreleme y\u00f6ntemleri kullanmal\u0131s\u0131n\u0131z. Ayr\u0131ca, header’lara ekledi\u011finiz verilerin boyutunu kontrol ederek performans sorunlar\u0131n\u0131 \u00f6nleyebilirsiniz. B\u00fcy\u00fck veri setlerini header’a eklemek yerine, ana g\u00f6vdeyi kullanman\u0131z daha uygun olabilir.<\/p>\n

Sonu\u00e7<\/h2>\n

Bu makalede, .NET Core Web API’de header’a \u00f6zel alan eklemenin iki farkl\u0131 y\u00f6ntemini inceledik. Her iki y\u00f6ntem de ayn\u0131 sonucu verir, ancak IActionResult kullan\u0131m\u0131 daha temiz ve okunabilir bir kod sa\u011flar. Unutmay\u0131n ki, header’lar meta veri ta\u015f\u0131mak i\u00e7in ideal bir yerdir, ancak g\u00fcvenlik ve performans a\u00e7\u0131s\u0131ndan dikkatli olman\u0131z gerekmektedir. Daha fazla bilgi i\u00e7in fatihsoysal.com<\/a> sitesini ziyaret edebilirsiniz.<\/p>\n

Umar\u0131m bu makale size yard\u0131mc\u0131 olmu\u015ftur! Herhangi bir sorunuz varsa, l\u00fctfen yorumlarda belirtin.<\/p>\n

Faydal\u0131 Kaynaklar:<\/strong><\/p>\n