API Endpoint Tasarımında Küçük Bir Detay, Büyük Bir Fark

Geçenlerde X’te gezinirken bir gönderiye denk geldim. Bir junior geliştiricinin tasarladığı iki endpoint paylaşılmıştı ve buradaki tasarım hatasının ne olduğu soruluyordu. Endpoint’ler şunlardı: GET /api/v1/followers/verified GET /api/v1/followers/unverified İlk bakışta çalışır gibi görünüyor. Hatta ne yapmak istediği de gayet anlaşılır: doğrulanmış takipçileri getir, doğrulanmamış takipçileri getir. Ama API tasarımında mesele sadece “anlaşılıyor mu?” değil. Asıl mesele, doğru modellenmiş mi? Bu