Focus mode

.Net Core

.NET 5 Giriş

Kurulumlar

Http Protokol

Örnek Web Api Yaratmak

Proje Dosyalarını Tanıma

Controllers, Route ve Action Methodlar

Swagger ve Postman kullanımı

BookStore Projesi Yaratmak

Veritabanı Yönetim Sistemleri

Orm ve Entity Framework Core

Entity, Model ve Mapper Kullanımı

Fluent Validation Kullanarak Modellerin Doğrulanması

Middleware Kavramı

Dependency Injection

Projeye Genre Controller ve Servislerin Eklenmesi

Ödev - Projeye Author Controller ve Servislerin Eklenmesi

TDD (Test Driven Development)

Ödev - Projenin eksik testlerinin tamamlanması

Kimlik Doğrulama ve Yetkilendirme Protokolleri

Proje Ödevi 1- Movie Store Uygulaması

Proje Ödevi 2 - Serbest Proje Seçimi

Coderbyte Challenge

Okunabilir API tasarımı

Okunabilir API Tasarımı

Okunabilir API'lar tasarlamak sizin developerlar ile ortak bir dil konuşabilmeniz için oldukça önemlidir. Projeye sizden sonra dahil olacak developlerların sadece içgüdüsel olarak endpointe baktığında hangi amaçla yaratıldığını anlayabiliyor olması gerekir. Aynı zamanda API'nizi kullanacak olan diğer developerlar da ilk bakışta bir API'ın isimlendirmesinden hangi amaçla kullanıldığını rahatlıkla anlayabilmelidir.

Bu amaçla okunabilir API tasarlamak için aşağıdaki genel kurallara dikkat edilerek API isimlendirmek doğru bir yöntem olacaktır.

Aksiyon ifadelerinden kaçınılmalı : Aksiyon ifadelerini sizin yerinize http verb'leri zaten yapacaktır, bu nedenle isimlendirme yapılırken aksiyon ifadelerinden kaçınılmalıdır.
Örnek : /Books/getBooks yerine zaten bu isteği HTTP GET ile yapacağımızdan yalnızca /Books/ olması daha doğru olacaktır. Bir endpointi okurken önünde hangi http verb kullanacaksak onunla birlikte okuyarak isimlendireceğimizi düşünmeliyiz.
Controller yani resource isimlendirmesi çoğul olacak şekilde yapılmalı. Doğası gereği aslında bu kaynakların çoğul yani birden fazla olduğunu göz önünde bulundurmalıyız.
Örnek : Book/yerine Books/ kullanılmalı.

Örnekler :

Okuma Önerisi: Okunabilir API tasarımı ile ilgili daha detaylı bilgi almak için tıklayınız.

For a quick start in software development from scratch, check out our specialized training courses

Do you need more education, projects, and mentor support in your journey to learn programming? Join Patika+'s intensive 4-8 month bootcamps, gain all the necessary skills with project-based live classes and customized trainings for you, and start your career!

Test

Comments

You need to enroll in the course to be able to comment!