ASP.NET Core REST

3 dakika

Bir Web sayfasına gözattığınızda, Web sunucusu, HTML, CSS ve JavaScript kullanarak tarayıcılarınız ile iletişim kurar. Bir oturum açma formu göndermek veya satın al düğmesine tıklamak gibi bir şey yaparak sayfayla etkileşime geçerek, tarayıcı bilgileri Web sunucusuna geri gönderir.

Benzer şekilde, Web sunucuları tarayıcılar, mobil cihazlar, diğer Web sunucuları ve daha fazlasını içeren çok sayıda istemciyle iletişim kurabilir, Web Hizmetleri 'ni kullanabilirsiniz. API istemcileri, HTTP üzerinden sunucu ile ve JSON veya XML gibi bir veri biçimi kullanarak iki Exchange bilgisi ile iletişim kurar. API 'Ler, genellikle Web API 'Lerini kullanarak Web sunucusuyla iletişim kurarak web tarayıcısında Kullanıcı arabirimi mantığının çoğunu gerçekleştiren tek sayfalı uygulamalarda (maça 'lar) kullanılır.

REST: HTTP ile API 'Ler oluşturmak için ortak bir örüntü

Temsili durum aktarımı (REST), Web hizmetleri oluşturmak için bir mimari stillidir. Web tarayıcılarının Web sayfalarını almak ve sunuculara veri göndermek için kullandığı HTTP yüklemleri kullanılarak REST istekleri HTTP üzerinden yapılır. Fiiller şunlardır:

Get – bu işlem, Web hizmetinden verileri almak için kullanılır.
Post – bu işlem, Web hizmetinde yeni bir veri öğesi oluşturmak için kullanılır.
PUT – bu işlem, Web hizmetindeki bir veri öğesini güncelleştirmek için kullanılır.
Patch – bu işlem, öğenin nasıl değiştirileceği hakkında bir dizi yönerge açıklayarak Web hizmetindeki bir veri öğesini güncelleştirmek için kullanılır. Bu fiil örnek uygulamada kullanılmaz.
Sil – bu işlem, Web hizmetindeki bir veri öğesini silmek için kullanılır.

REST 'e bağlı Web hizmeti API 'Lerine, yeniden kullanılabilir API 'Ler denir ve kullanılarak tanımlanmıştır:

Temel URI.
GET, POST, PUT, PATCH veya DELETE gibi HTTP yöntemleri.
Veriler için JavaScript Nesne Gösterimi (JSON) veya XML gibi bir medya türü.

Bir API genellikle farklı, ilgili birkaç şey için hizmetler sağlamalıdır. Örneğin, pizza API 'imiz, Pizzas, müşteriler ve siparişleri yönetebilir. Kodlarımızda bulunan mantıksal bölümlere yönelik olarak , isteklerin öğesine yönlendirilmesi sırasında istekleri bir öğesine http://localhost:5000/Pizza yönlendirirken yönlendiririz PizzaController http://localhost:5000/order OrderController .

ASP.NET Core API oluşturma avantajları

ASP.NET ile hem web sayfalarını hem de hizmetleri derlemek için aynı framework ve desenleri kullanabilirsiniz. Bu, model sınıflarını, doğrulama mantığını yeniden kullanabileceğiniz ve hatta hem Web sayfalarına hem de hizmetlere aynı projede yan yana hizmet verebileceği anlamına gelir. Bu yaklaşımın çeşitli avantajları vardır.

Avantaj: basit serileştirme

ASP.NET modern web deneyimleri için tasarlanmıştır. Uç noktalar, sınıflarınızı otomatik olarak doğru şekilde biçimlendirilen JSON 'ları kullanıma almak için otomatik olarak serileştirin Özel yapılandırma gerekmez. Kuşkusuz, serileştirme benzersiz gereksinimlere sahip uç noktalar için özelleştirilebilir .

Avantaj: kimlik doğrulama ve yetkilendirme

Endüstri standardı JSON Web belirteçleri (JWT) için yerleşik destek içeren API uç noktaları güvenli. İlke tabanlı yetkilendirme, size güçlü erişim denetimi kuralları tanımlama esnekliği sağlar (hepsi kodda).

Avantaj: kodunuzun yanı sıra yönlendirme

ASP.NET öznitelikleri kullanarak, kodunuzla satır içi yollar ve fiiller tanımlamanızı sağlar. İstek yolundan, sorgu dizesinde ve istek gövdesinden alınan veriler otomatik olarak Yöntem parametrelerine bağlanır.

Avantaj: varsayılan olarak https

HTTPS, modern, profesyonel Web API 'lerinin önemli bir parçasıdır. Gizlilik sağlamak için uçtan uca şifrelemeyi kullanır ve API çağrılarınızın, istemci ile sunucu arasında yakalanmadığından ve değiştirilmediğinden emin olun. ASP.NET, ilk olarak HTTPS için sınıf desteğini kutudan çıkar. Otomatik olarak bir test sertifikası oluşturur ve uygulamanızı yayımlamadan önce, uygulamalarınızı güvenli bir şekilde çalıştırıp hata ayıklamanızı sağlayacak şekilde yerel HTTPS 'yi etkinleştirmek için kolayca içeri aktarır.

.NET becerilerinizi ve ekosisteminizi kullanarak Web API 'nizden mobil, Web, Masaüstü, hizmetler ve daha fazlasını içeren .NET ile oluşturulmuş diğer uygulamalara mantık paylaşabilirsiniz.

.NET HTTP REPL kullanarak Web API 'Lerini test etme

Geleneksel bir Web sitesi geliştirirken, genellikle çalışmanızı bir Web tarayıcısında görüntüleyip test edersiniz. Web API 'Leri HTML yerine verileri kabul eder ve döndürür, bu nedenle web tarayıcısı en iyi Web API test aracı değildir. Web API 'Leri keşfetmek ve bunlarla etkileşim kurmak için kullanılan en kolay seçenekten biri .net http REPL'ıdır. REPL, R EAD-E Val-P rint L OOP 'yi temsil eder. Bu, yapı etkileşimli komut satırı ortamları için basit ve popüler bir yoldur. Sonraki bölümde, basit bir Web API 'SI oluşturacak ve .NET HTTP REPL kullanarak onunla etkileşime gilecektir.

Bilginizi ölçün

Devam et