ASP.NET Core Web API'de Parametre Bağlama Yöntemleri: FromQuery, FromBody ve FromRoute

ASP.NET Core web API projeleri, istemcilerden gelen verileri API metotlarıyla etkileşimde bulunmak için kullanılır. Bu verileri doğru bir şekilde almak ve işlemek için parametre bağlama yöntemleri kullanılır. Bu yazımda, ASP.NET Core web API projelerinde yaygın olarak kullanılan üç parametre bağlama yöntemi olan FromQuery, FromBody ve FromRoute'u ele alacağız.

FromQuery

API metodu içindeki parametrelere HTTP isteği URL'sindeki sorgu parametrelerini bağlamak için kullanılır. Sorgu parametreleri, URL'nin "?" karakterinden sonra gelen anahtar-değer çiftleri şeklinde belirtilen verilerdir. Örneğin, https://example.com/api/products?id=123&name=keyboard gibi bir URL'de "id" ve "name" sorgu parametreleri bulunmaktadır. FromQuery yöntemi, bu sorgu parametrelerini bir API metodu içindeki parametrelere bağlamak için kullanılır.

[HttpGet("products")]
public IActionResult GetProduct([FromQuery] int id, [FromQuery] string name)
{
    // id ve name parametreleri kullanılabilir
    // ...
}

FromBody

API metodu içindeki bir parametreye HTTP isteği gövdesindeki verileri bağlamak için kullanılır. Genellikle POST, PUT veya PATCH gibi isteklerde kullanılır. Gövdedeki veriler JSON, XML veya başka bir veri formatında olabilir. FromBody yöntemi, bu gövde verilerini bir API metodu içindeki bir parametreye bağlamak için kullanılır.

[HttpPost("products")]
public IActionResult CreateProduct([FromBody] ProductDto productDto)
{
    // Gövdedeki verileri içeren ProductDto nesnesi kullanılabilir
    // ...
}

FromRoute

API metodu içindeki bir parametreye URL'deki yönlendirme parametrelerini bağlamak için kullanılır. Yönlendirme parametreleri, URL'nin belirli bir bölümünde belirtilen dinamik değerlerdir. Örneğin, https://example.com/api/products/{id} gibi bir URL'de "id" yönlendirme parametresi bulunmaktadır. FromRoute yöntemi, bu yönlendirme parametresini bir API metodu içindeki bir parametreye bağlamak için kullanılır. Yaygın olarak resource'a ait id bilgisi okurken kullanılır.

[HttpGet("products/{id}")]
public IActionResult GetProductById([FromRoute] int id)
{
    // id parametresi kullanılabilir
    // ...
}

Sonuç

ASP.NET Core web API projelerinde, FromQuery, FromBody ve FromRoute gibi parametre bağlama yöntemleri, istemciden gelen verileri API metotlarına bağlamak için kullanılır. Bu yöntemler sayesinde istemcilerin sağladığı verilere kolayca erişebilir ve işleyebilirsiniz. Bu yazıda ele aldığımız parametre bağlama yöntemlerinin kullanımı ve örnekleri, web API projelerinizde verileri doğru bir şekilde almanıza yardımcı olacaktır.

Umarım faydalı olmuştur. İyi çalışmalar dilerim.

• #aspnetcore
• #webapi

Paylaş:

• Facebook
• Twitter
• Google+
• Pinteres
• WhatsApp
• LinkedIn