C# ile Web API Geliştirme: Kapsamlı Rehber
Web API‘ler, modern yazılım mimarilerinin ayrılmaz bir parçasıdır. Bu rehberde, Web API’nin ne olduğundan başlayarak, C# ile nasıl geliştirileceğine kadar geniş bir perspektif sunacağım. Ayrıca HTTP metodları, güvenlik protokolleri ve API test süreçlerine de değineceğim.
Web API Nedir? 🤔
Web API (Application Programming Interface), uygulamalar arası iletişimi kolaylaştırmak için kullanılan bir arayüz setidir. Web tabanlı uygulamalar, farklı uygulamalarla veri alışverişi yapmak için Web API’lerini kullanır.
Web API’nin Avantajları ✨
Platform Bağımsızlık: Farklı platformlar ve teknolojiler arasında veri alışverişi yapılabilir.
Dil Bağımsızlığı: Çeşitli programlama dilleri tarafından kullanılabilir.
Ölçeklenebilirlik: Küçükten büyüğe projelerde kolaylıkla ölçeklenebilir.
Bakım Kolaylığı: Merkezi bir noktadan yönetilir ve güncellenir.
Web API Nasıl Çalışır? ⚙️
Web API’ler, HTTP protokolü üzerinden çalışır ve URL (Uniform Resource Locator) aracılığıyla erişilen kaynaklara HTTP istekleri gönderir. Bu istekler, bir URL, HTTP metodları ve başlık bilgileri içerir.
URL ve URI Nedir? 🔗
URL (Uniform Resource Locator): Bir kaynağın internet üzerindeki konumunu belirtir. Örneğin:
https://www.example.com/api/usersURI (Uniform Resource Identifier): Bir kaynağı tanımlayan geniş kapsamlı bir terimdir ve URL’ler bu kategorinin bir alt kümesidir.
EndPoint Nedir? 📍
Endpoint, bir API’nin belirli bir kaynağa erişmek için tanımladığı URL’nin spesifik bir bölümüdür. Örneğin, /users bir kullanıcı listesine erişmek için kullanılan bir endpoint olabilir.
HTTP ve HTTPS Nedir? 🔒
HTTP (Hypertext Transfer Protocol): Web üzerinde bilgi alışverişi yapmak için kullanılan protokoldür.
HTTPS (Hypertext Transfer Protocol Secure): HTTP’ye şifreleme ekleyerek daha güvenli hale getirilmiş halidir.
HTTP Verb’ler Nelerdir? 🚦
HTTP metodları, bir Web API ile etkileşime geçmek için kullanılan operasyonları belirler:
GET: Veri okumak için kullanılır.
POST: Yeni veri yaratmak için kullanılır.
PUT: Mevcut veriyi güncellemek için kullanılır.
DELETE: Veriyi silmek için kullanılır.
Header Nedir? 📄
HTTP isteğinin veya yanıtının başlığında yer alan, istek veya yanıtın özellikleri hakkında bilgi taşıyan parametrelerdir. Örneğin, içerik türü veya yetkilendirme bilgileri bu başlıkta taşınabilir.
Query String Nedir? 🔍
URL’nin sonuna eklenen, anahtar-değer çiftleri içeren bir dizi bilgidir. Örneğin, ?userId=123&status=active bir kullanıcının belirli bir durumdaki bilgilerini sorgulamak için kullanılabilir.
Postman ve API Testi 🧪
Postman, API’lerin geliştirilmesi, test edilmesi ve dokümantasyonunun yapılması için kullanılan popüler bir araçtır. API endpoint’lerine istek göndermek, yanıtları incelemek ve farklı senaryoları test etmek için idealdir.
C# ile Web API Yazımı 🖥️
C# ve .NET platformu kullanarak basit bir Web API uygulaması geliştirelim. İşte temel bir kullanıcı yönetimi API’si:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | using Microsoft.AspNetCore.Mvc; [Route("api/[controller]")] [ApiController] public class UsersController : ControllerBase { private static List<User> users = new List<User>{ new User{Id=1, Name="Halil", Email="info@halilsahin.net"} }; [HttpGet] public ActionResult<List<User>> GetAllUsers() { return users; } [HttpPost] public IActionResult AddUser(User user) { users.Add(user); return CreatedAtAction("GetAllUsers", new { id = user.Id }, user); } } |
HTTP Durum Kodları 🚥
HTTP yanıtlarını belirleyen kodlardır:
200 OK: İstek başarıyla işlendi.
201 Created: Yeni bir kaynak başarıyla oluşturuldu.
400 Bad Request: İstek hatalı veya yanlış formatlı.
401 Unauthorized: Kimlik doğrulama gerekiyor.
404 Not Found: İstenen kaynak bulunamadı.
500 Internal Server Error: Sunucu tarafında bir hata oluştu.
Bu rehber, C# ve .NET ile Web API geliştirme sürecinin her yönünü kapsamlı bir şekilde ele almaktadır. Bu bilgiler ışığında, güvenli, etkili ve ölçeklenebilir API’ler geliştirebilirsiniz. 🚀