Ö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.