Öncelikle şunu belirtmek isterim ki, genel ağ siteleri ve benzeri yazılım sistemlerinde evrensel olarak kabul edilmiş tek bir "doğru yöntem" yoktur. Sektör tarafından sıkça tercih edilen veya Google, NASA gibi belirli organizasyonların yayımladığı stil rehberleri (Style Guides) olsa da, en doğru yaklaşım, sistemi kendi ihtiyaçlarınıza göre şekillendirmenizdir.
Örneğin ben, okunabilirlik açısından rotaları (route) şahsen aşağıdaki gibi oluşturmayı tercih ediyorum:
POST /auth/register = Kayıt olma
POST /auth/login = Giriş yapma
GET /posts = Gönderileri listeleme
POST /posts = Gönderi oluşturma
GET /posts/:postId = Tek bir gönderiyi görüntüleme
PATCH /posts/:postId = Gönderi düzenleme
DELETE /posts/:postId = Gönderi silme
Bu tür rotaları tasarlarken asıl hedefiniz, belirli bir standarda uymaktan ziyade projenizin gerçek ihtiyaçlarını karşılamak olmalıdır. Bu nedenle en verimli yöntem; rota listenizi oluşturmadan önce bir özellik listesi hazırlamak ve bu özelliklere hizmet edecek rotaları tasarlamaktır.
Ama eğer ekleyebileceğiniz özellik önerisi isterseniz şunlar olabilecek özellikler olabilir: gönderi yorumları, gönderi kategorileri, gönderi arama. Bunları ise örnek olarak şu şekilde yapabilirsiniz:
GET /categories = Kategorileri listeleme
GET /categories/:categoryId/posts = Kategoriye ait gönderileri listeleme
GET /search?q={arama içeriği} = İçerik arama
GET /posts/:postId/comments = Gönderinin yorumlarını listeleme
POST /posts/:postId/comments = Gönderiye yeni yorum ekle
DELETE /posts/:postId/comments/:commentId = Bir yorumu silme
YADA
DELETE /comments/:commentId = Bir yorumu silme
Birinci yaklaşım çok açık olsa da, bir yorumu silmek için hem gönderinin hem de yorumun ID'sine ihtiyaç duyar. Her yorumun zaten kendine özgü (unique) bir ID'si olduğu varsayarsak ikinci yaklaşım ise daha yaygındır. Bu nedenle gönderi ID'sini URL'de tekrar belirtmek gereksizdir. Bu yaklaşım hem daha sadedir hem de API'nizin yönetimini kolaylaştırır. Fakat bu durum yine de bir tercih meselesidir.
Ayrıca rotalarınızı belirlerken olabildiğince HTTP Standart metotlarını tercih etmeniz hem tarayıcılar hemde okunabilirlik açısından daha olumlu olacaktır.[1]
Şimdiden kolay gelsin.
Kaynaklar
-
MDN Web Docs. Http Request Methods - Http | Mdn. (13 Mart 2025). Alındığı Tarih: 29 Haziran 2025. Alındığı Yer: MDN Web Docs
| Arşiv Bağlantısı
