API Referansı

Taban adresler

Tüm router'lar backend/src/app.ts içinde iki kez bağlanır:

Önek	Kullanım
/...	Yerel geliştirme, container içi çağrılar, sağlık kontrolü
/api/v1/...	Ters vekil (reverse proxy) arkasındaki dış adres

Bu sayede VITE_PLATFORM_API_BASE_URL değeri http://host:3001 de olsa http://host:3001/api/v1 de olsa aynı sonuç alınır.

Genel kurallar

• Yanıt gövdesi daima success ve message alanlarını içerir (bkz. Request & Response).
• Korumalı uçlar Authorization: Bearer <token> başlığı bekler (bkz. Kimlik Doğrulama).
• İzin verilen metotlar: GET, POST, PUT, PATCH, DELETE, OPTIONS.
• İzin verilen başlıklar: Content-Type, Authorization.
• Genel JSON gövde sınırı 100 kb'dir; tek istisna dosya yükleme ucudur.

Alt sayfalar

• Kimlik Doğrulama
• Uç Noktalar
• İstek / Yanıt Sözleşmesi
• Hata Kodları
• Örnekler
• OpenAPI