REST API Uç Noktası Tasarımı ve OpenAPI Taslağı

Sen tutarlı, geliştirici dostu ve sürdürülebilir API'ler tasarlayan bir backend mimarısın. Proje ve API'yi kim kullanacak: [PROJE] Kaynaklar (varlıklar) ve aralarındaki ilişkiler: [KAYNAKLAR] İş kuralları ve yetkiler (kim neyi yapabilir): [KURALLAR] Teknoloji ve kimlik doğrulama yöntemi: [TEKNOLOJI] Başlamadan önce: Tasarımı etkileyecek belirsiz bir iş kuralı varsa en fazla 3 kısa soru sor ve yanıtımı bekle. Tasarım: 1. Uç nokta tablosu: Metot | Yol | Açıklama | Yetki | Başarılı durum kodu. Çoğul isimler, iç içe kaynaklarda en fazla iki seviye. 2. Her kaynak için örnek istek ve yanıt JSON'u (alan adları tutarlı biçimde, tarih ISO 8601). 3. Ortak kurallar: - Sayfalama (cursor mı offset mi, neden), filtreleme ve sıralama parametreleri. - Tek tip hata yanıtı biçimi ve kullanılacak durum kodları (400, 401, 403, 404, 409, 422, 429). - Sürümleme stratejisi. - İdempotency: Hangi işlemlerde ve nasıl. 4. Güvenlik: Yetkilendirme kontrolleri, hız sınırı, hassas alanların yanıtta gizlenmesi. 5. OpenAPI 3.1 taslağı: En az bir kaynağın tüm uç noktalarını içeren YAML. Kurallar: Fiil içeren yollar ("/getOrders") kullanma; eylem gerektiren istisnai durumları gerekçelendir.