Plattform API

Plattform und Laufzeitoberfläche

Gesundheitstests, Funktionsflags, Überwachung und Aufnahme von Sicherheitsberichten

Diese Endpunkte befinden sich außerhalb der Kernproduktcontroller und unterstützen Laufzeitzustand, Metriken, Client-Telemetrie, Flags für öffentliche Funktionen und Aufnahme von Sicherheitsberichten.

Überwiegend öffentliche StreckenGesundheit und BereitschaftPrometheus-MetrikenSicherheitsberichte

Authentifizierung und Umfang

• Alle Endpunkte auf dieser Seite sind öffentlich.
• Diese Routen sind auf die Infrastruktur oder die Missbrauchserkennung ausgerichtet und nicht auf Endbenutzer-Funktions-APIs.
• Die Erstellung und Verwaltung des Benutzerschlüssels API ist in Authentication API dokumentiert.

Endpunktreferenz

Gesundheit und Verfügbarkeit

Methode	Pfad	Zweck	Anfrage oder Anfrage	Auth
GET	/api/	Antwort der Root-App.	Keine	Öffentlich
GET	/api/health	Lebendigkeitssonde.	Keine	Öffentlich
GET	/api/healthz	Legacy-Liveness-Alias.	Keine	Öffentlich
GET	/api/ready	Bereitschaftsprüfung mit DB-Prüfung.	Keine	Öffentlich

Flags und Überwachung

Methode	Pfad	Zweck	Anfrage oder Anfrage	Auth
GET	/api/feature-flags	Gibt den aktuellen Feature-Flag-Snapshot zurück.	Keine	Öffentlich
GET	/api/monitoring/metrics	Prometheus-Metriktext zurückgeben.	Keine	Öffentlich
GET	/api/monitoring/metrics/json	Gibt JSON-Metriken zurück.	Keine	Öffentlich
POST	/api/monitoring/frontend-errors	Frontend-Fehlerberichte aufnehmen.	Text: Frontend-Fehlernutzlast	Öffentlich

Sicherheitsberichte

Methode	Pfad	Zweck	Anfrage oder Anfrage	Auth
POST	/api/security/reports/ct	Erhalten Sie Zertifikatstransparenz- oder ähnliche Sicherheitsberichte.	Text: Nutzlast des Sicherheitsberichts	Öffentlich
POST	/api/security/reports/csp	Erhalten Sie Berichte über CSP-Verstöße.	Text: Nutzlast des Sicherheitsberichts	Öffentlich

Fordern Sie Formen an

Frontend-Fehlerberichte

FrontendErrorReportDto

• source: erforderliche Zeichenfolge, maximal 180 Zeichen
• message: erforderliche Zeichenfolge, maximal 400 Zeichen
• stack: optionale Zeichenfolge, maximal 10.000 Zeichen
• url: optionale Zeichenfolge, maximal 400 Zeichen
• severity: optional error|warn|info
• details: optionales Objekt

Sicherheitsberichte

• Der Controller akzeptiert Nutzlasten im Stil report und cspReport.

Beispielanrufe

Bereitschaft lesen

curl "$PRIMECAL_API/api/ready"

Funktionsflags abrufen

curl "$PRIMECAL_API/api/feature-flags"

Senden Sie einen Frontend-Fehler

curl -X POST "$PRIMECAL_API/api/monitoring/frontend-errors" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "calendar-view",
    "message": "Week view render failed",
    "severity": "error",
    "url": "https://app.primecal.eu/app"
  }'

Hinweise zu Reaktion und Verhalten

• POST /api/monitoring/frontend-errors gibt 202 Accepted zurück.
• Sicherheitsberichtsendpunkte geben 204 No Content zurück.
• Feature-Flags sind absichtlich öffentlich, damit das Frontend Abläufe vor der Anmeldung gestalten kann.

Best Practices

• Verwenden Sie /api/health und /api/ready für Bereitstellungs- und Lastausgleichstests, nicht für kundenorientierte Dashboards.
• Schützen Sie die Privatsphäre der Frontend-Fehlernutzlasten. Geben Sie keine Token, E-Mail-Adressen oder Rohgeheimnisse in details preis.
• Trennen Sie Beobachtbarkeitsbedenken von der Produktlogik in Clients. Diese Routen sollten normalerweise in Plattform-SDK-Ebenen und nicht in Funktionsmodulen vorhanden sein.