Platform API

Platform és futási felület

Egészségügyi szondák, funkciójelzők, figyelés és biztonsági jelentések feldolgozása

Ezek a végpontok az alapvető termékvezérlőkön kívül helyezkednek el, és támogatják a futásidejű állapotot, a mérőszámokat, ügyfél telemetria, nyilvános funkciójelzők és biztonsági jelentések feldolgozása.

Többnyire nyilvános útvonalakEgészség és felkészültségPrometheus-metrikákBiztonsági jelentések

Hitelesítés és hatókör

• Ezen az oldalon minden végpont nyilvános.
• Ezek az útvonalak infrastruktúrára vagy visszaélések észlelésére irányulnak, nem pedig végfelhasználói szolgáltatás API-k.
• A API felhasználói kulcs létrehozása és kezelése a Authentication API dokumentumban található.

Végpont referencia

Egészség és elérhetőség

módszer	Útvonal	Cél	Kérjen vagy érdeklődjön	Auth
GET	/api/	Root alkalmazás válasza.	Egyik sem	Nyilvános
GET	/api/health	Életesség szonda.	Egyik sem	Nyilvános
GET	/api/healthz	Legacy liveness alias.	Egyik sem	Nyilvános
GET	/api/ready	Készenléti szonda DB ellenőrzéssel.	Egyik sem	Nyilvános

Zászlók és felügyelet

módszer	Útvonal	Cél	Kérjen vagy érdeklődjön	Auth
GET	/api/feature-flags	Az aktuális funkciójelző pillanatképének visszaadása.	Egyik sem	Nyilvános
GET	/api/monitoring/metrics	Vissza a Prometheus metrika szövegét.	Egyik sem	Nyilvános
GET	/api/monitoring/metrics/json	Visszatérési mutatók JSON.	Egyik sem	Nyilvános
POST	/api/monitoring/frontend-errors	Foglalja le a frontend hibajelentéseket.	Törzs: frontend error payload	Nyilvános

Biztonsági jelentések

módszer	Útvonal	Cél	Kérjen vagy érdeklődjön	Auth
POST	/api/security/reports/ct	Tanúsítvány-átlátszósági vagy hasonló biztonsági jelentéseket kaphat.	Test: biztonsági jelentés rakomány	Nyilvános
POST	/api/security/reports/csp	CSP-sértési jelentések fogadása.	Test: biztonsági jelentés rakomány	Nyilvános

Kérjen alakzatokat

Frontend hibajelentések

FrontendErrorReportDto

• source: kötelező karakterlánc, legfeljebb 180 karakter
• message: kötelező karakterlánc, legfeljebb 400 karakter
• stack: opcionális karakterlánc, legfeljebb 10000 karakter
• url: opcionális karakterlánc, legfeljebb 400 karakter
• severity: nem kötelező error|warn|info
• details: opcionális objektum

Biztonsági jelentések

• A biztonsági jelentés végpontjai elfogadják a SecurityReportDto hasznos adat alakzatot.
• A vezérlő report és cspReport stílusú rakományokat is elfogad.

Példahívások

Olvasási készenlét

curl "$PRIMECAL_API/api/ready"

Funkciójelzők lekérése

curl "$PRIMECAL_API/api/feature-flags"

Küldjön be előtérbeli hibát

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"
  }'

Válasz és viselkedés megjegyzések

• POST /api/monitoring/frontend-errors a következőt adja vissza: 202 Accepted.
• A biztonsági jelentés végpontjai a következőt adják vissza: 204 No Content.
• A funkciójelzők szándékosan nyilvánosak, így a kezelőfelület alakíthatja a bejelentkezés előtti folyamatokat.

Legjobb gyakorlatok

• A /api/health és a /api/ready a telepítési és terheléselosztási szondákhoz használható, az ügyfelek felé néző irányítópultokhoz ne.
• Tartsa biztonságban a frontend hibaadatait. Ne szivárogtasson ki tokeneket, e-mail címeket vagy nyers titkokat a details-ban.
• Az ügyfeleknél különítse el a megfigyelhetőségi aggályokat a terméklogikától. Ezeknek az útvonalaknak általában platform SDK-rétegekben kell élniük, nem pedig modulokban.