Uç Noktalar

Aşağıdaki envanter backend/src/routers/ altındaki gerçek route tanımlarından çıkarılmıştır. Her uç hem /<yol> hem /api/v1/<yol> olarak erişilebilir.

Sağlık

Servis sağlığı

Method: GET   Endpoint: /health   Authentication: Gerekmez

Purpose: Container sağlık kontrolü ve harici izleme. Veritabanı bağlantısını ping komutuyla gerçekten doğrular.

Response 200

{
  "success": true,
  "message": "Servis çalışıyor",
  "status": "ok",
  "database": "connected"
}

Response 503

{
  "success": false,
  "message": "Veritabanı bağlantısı yok.",
  "status": "error",
  "database": "disconnected"
}

Ping başarısız olursa mesaj "Veritabanına erişilemiyor." olur.

Source: routers/health.routes.ts, controllers/health.controller.ts

Kimlik doğrulama

Giriş

Method: POST   Endpoint: /login   Authentication: Gerekmez (hız sınırlı)

Source: routers/auth.routes.ts

API dokümantasyon kayıtları

Method	Endpoint	Auth	Amaç
POST	/create-api-doc	JWT	Yeni API kaydı oluşturur
PUT	/update-api-doc/:id	JWT	Mevcut kaydı günceller
GET	/api-docs-list	JWT	Kayıtları listeler
DELETE	/delete-api-doc/:id	JWT	Kaydı siler

Gövde alanları: api_name (zorunlu), url, engine_type, total_count, system_count, input_count, output_count.

engine_type opsiyoneldir; doluysa yalnızca system, input veya output olabilir (katı doğrulama — INPUT, abc gibi değerler reddedilir).

Source: routers/api-doc.routes.ts, controllers/api-doc.controller.ts, services/api-doc.service.ts, models/api-doc.model.ts

OpenAPI

Method	Endpoint	Auth	Amaç
GET	/openapi.yaml	Gerekmez	Ham OpenAPI dokümanı (YAML)
GET	/openapi.json	Gerekmez	Aynı doküman JSON'a çevrilmiş

Source: routers/docs.routes.ts (backend/api/openapi.yaml okunur)

Dosya yükleme

Method	Endpoint	Auth	Amaç
POST	/platform/files/upload	JWT	MinIO'ya dosya yükler (base64 gövde)
POST	/fileAddd	JWT	Legacy alias — yeni kodda kullanılmaz

Bu iki yol, 100 kb'lık genel gövde sınırından muaftır; sınır PLATFORM_UPLOAD_BODY_LIMIT değişkeninden gelir.

Source: routers/platform-file.routes.ts, services/platform-file.service.ts

Node-RED akışından taşınan uçlar

Method	Endpoint	Auth	Amaç
GET	/iqv_notlar_listele	Yok	Notları listeler
GET	/iqv_not_hatirlatici_listele	Yok	Not hatırlatıcılarını listeler
POST	/iqv_not_hatirlatici_olustur	Yok	Not hatırlatıcısı ekler/günceller
DELETE	/iqv_not_hatirlatici_sil	Yok	Not hatırlatıcısı siler
POST	/platform-reminder-list	Yok (soft)	Platform hatırlatıcılarını listeler
POST	/platform-reminder-update	Yok (soft)	Platform hatırlatıcısı ekler/günceller
DELETE	/platform-reminder-delete	Yok (soft)	Platform hatırlatıcısı siler
POST	/send-mail-box	Yok	Mail box gönderimi
GET	/getUser	JWT	Kullanıcıları listeler

Soft-auth notu

Node-RED akışında bazı uçlarda "JWT Auth Guard" düğümü token'ı okur, msg.auth içine yazar ancak isteği engellemez. Bu davranış taşınırken korunmuştur. Tek istisna GET /getUser'dır: denetimde kimlik doğrulamasız veri sızdırdığı için artık authenticate ile korunmaktadır.

Source: routers/nodered.routes.ts

Kapsam dışı

POST /login, GET /health ve POST /iqv_platform_log Node-RED taşıma kapsamı dışında tutulmuş, mevcut uygulamadaki hâlleriyle bırakılmıştır.