api-design

原文涵盖的主题

• API Tasarım Kalıpları
• Ne Zaman Aktifleştirmeli
• Kaynak Tasarımı
• URL Yapısı
• İsimlendirme Kuralları
• HTTP Metodları ve Durum Kodları
• Metod Semantiği
• Durum Kodu Referansı

Tutarlı, geliştirici dostu REST API'leri tasarlamak için konvansiyonlar ve en iyi uygulamalar. Yeni API endpoint'leri tasarlarken Mevcut API sözleşmelerini incelerken Sayfalama, filtreleme veya sıralama eklerken API'ler için hata işleme uygularken API versiyonlama stratejisi planlarken Halka açık veya iş ortağı odaklı API'ler oluştururken | Metod | Idempotent | Güvenli | Kullanım Amacı | |--------|-----------|------|---------| | GET | Evet | Evet | Kaynakları getir | | POST | Hayır | Hayır | Kaynak oluştur, aksiyonları tetikle | | PUT | Evet | Hayır | Kaynağın tam değişimi | | PATCH | Hayır | Hayır | Kaynağın kısmi güncellemesi | | DELETE | Evet | Hayır | Kaynağı kaldır | PATCH uygun implementasyonla idempotent yapılabilir Artıları: Uygulaması kolay, "N sayfasına git" destekler Eksileri: Büyük offset'lerde yavaş (OFFSET 100000), eş zamanlı eklemelerde tutarsız Artıları: Pozisyondan bağımsız tutarlı performans, eş zamanlı eklemelerde kararlı Eksileri: Rastgele sayfaya atlayamaz, cursor opak | Kullanım Senaryosu | Sayfalama Tipi | |----------|----------------| | Admin panelleri, küçük veri setleri (<10K) | Offset | | Sonsuz kaydırma, akışlar, büyük veri setleri | Cursor | | Halka açı

这里只展示节选，请以完整原文和当前要求为准。