Plateforme API

Plateforme et surface d'exécution

Sondes d'intégrité, indicateurs de fonctionnalités, surveillance et ingestion de rapports de sécurité

Ces points de terminaison se situent en dehors des contrôleurs de produit principaux et prennent en charge l'état d'exécution, les métriques, télémétrie client, indicateurs de fonctionnalités publiques et ingestion de rapports de sécurité.

Itinéraires principalement publicsSanté et préparationMétriques PrometheusRapports de sécurité

Authentification et portée

• Tous les points de terminaison de cette page sont publics.
• Ces routes sont orientées vers l'infrastructure ou vers la détection d'abus, et non des API de fonctionnalités pour l'utilisateur final.
• La création et la gestion de la clé API de l'utilisateur sont documentées dans Authentication API.

Référence du point de terminaison

Santé et disponibilité

Méthode	Chemin	Objectif	Demande ou requête	Authentification
GET	/api/	Réponse de l'application racine.	Aucun	Publique
GET	/api/health	Sonde de vivacité.	Aucun	Publique
GET	/api/healthz	Alias ​​d’activité hérité.	Aucun	Publique
GET	/api/ready	Sonde de préparation avec vérification de la base de données.	Aucun	Publique

Indicateurs et surveillance

Méthode	Chemin	Objectif	Demande ou requête	Authentification
GET	/api/feature-flags	Renvoie l’instantané actuel de l’indicateur de fonctionnalité.	Aucun	Publique
GET	/api/monitoring/metrics	Renvoie le texte des métriques Prometheus.	Aucun	Publique
GET	/api/monitoring/metrics/json	Renvoie les métriques JSON.	Aucun	Publique
POST	/api/monitoring/frontend-errors	Ingérez les rapports d’erreurs du frontend.	Corps : charge utile d'erreur frontale	Publique

Rapports de sécurité

Méthode	Chemin	Objectif	Demande ou requête	Authentification
POST	/api/security/reports/ct	Recevez des rapports de transparence des certificats ou des rapports de sécurité similaires.	Corps : charge utile du rapport de sécurité	Publique
POST	/api/security/reports/csp	Recevez des rapports de violation CSP.	Corps : charge utile du rapport de sécurité	Publique

Demander des formes

Rapports d'erreurs frontaux

FrontendErrorReportDto

• source : chaîne obligatoire, maximum 180 caractères
• message : chaîne obligatoire, maximum 400 caractères
• stack : chaîne facultative, maximum 10 000 caractères
• url : chaîne facultative, maximum 400 caractères
• severity : error|warn|info facultatif
• details : objet facultatif

Rapports de sécurité

• Les points de terminaison du rapport de sécurité acceptent la forme de charge utile SecurityReportDto.
• Le contrôleur accepte les charges utiles de style report et cspReport.

Exemples d'appels

Préparation à la lecture

curl "$PRIMECAL_API/api/ready"

Récupérer les indicateurs de fonctionnalité

curl "$PRIMECAL_API/api/feature-flags"

Soumettre une erreur frontend

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

Notes de réponse et de comportement

• POST /api/monitoring/frontend-errors renvoie 202 Accepted.
• Les points de terminaison du rapport de sécurité renvoient 204 No Content.
• Les indicateurs de fonctionnalités sont intentionnellement publics afin que le frontend puisse façonner les flux de pré-connexion.

Meilleures pratiques

• Utilisez /api/health et /api/ready pour les sondes de déploiement et d'équilibrage de charge, pas pour les tableaux de bord destinés aux clients.
• Protégez la confidentialité des charges utiles d’erreur frontale. Ne divulguez pas de jetons, d'adresses e-mail ou de secrets bruts dans details.
• Séparez les problèmes d’observabilité de la logique du produit chez les clients. Ces itinéraires doivent généralement résider dans les couches du SDK de la plate-forme, et non dans les modules de fonctionnalités.