NjanggoNjanggoDocumentation API
Tous

Status & disponibilité

Page publique status.njanggo.com, API JSON sans auth, healthchecks API/MCP · pour surveiller Njanggo avant d’appeler l’API ou le MCP.

Vue d’ensemble

Njanggo publie une status page publique pour que les consommateurs de l'API REST, du MCP et des webhooks puissent vérifier la disponibilité de la plateforme avant (ou pendant) une intégration.

Elle combine des sondes automatiques (web, API, base, docs, MCP, Pulse) et des incidents manuels publiés depuis Pulse. Aucune authentification n'est requise pour consulter le statut.

Où regarder en premier

Page humaine : https://status.njanggo.com. JSON machine : GET /api/status/public.

URL de redirection

Utilisez https://status.njanggo.com comme URL de redirection / lien statut dans vos runbooks, dashboards, pages d'erreur, README d'intégration MCP, ou messages d'incident.

UsageURL
Status page (UI)https://status.njanggo.com
API JSON (sans auth)https://api.njanggo.com/api/status/public
Santé API (liveness)https://api.njanggo.com/api/health
Santé API (readiness DB)https://api.njanggo.com/api/ready
Santé MCPhttps://mcp.njanggo.com/health
Docs APIhttps://docs.njanggo.com
MCP distanthttps://mcp.njanggo.com

Bonne pratique

Dans un client MCP, un bot Slack ou un script CI : si l'API renvoie 5xx ou timeout, redirigez l'opérateur vers https://status.njanggo.com pour voir si l'incident est déjà déclaré et quels composants sont touchés.

Exemple de message d'erreur côté intégrateur :

Exemple message
Njanggo est momentanément indisponible.
Statut en direct : https://status.njanggo.com
JSON : https://api.njanggo.com/api/status/public

API publique JSON

Endpoint public, sans clé API ni Bearer, non soumis au throttle habituel :

MéthodeCheminAuth
GET/api/status/publicAucune
curl -X GET "https://api.njanggo.com/api/status/public" \
  -H "Accept: application/json"

Champs utiles de la réponse :

ChampDescription
overalloperational | degraded | outage
updatedAtHorodatage ISO de la réponse
groups[].components[]Statut courant, uptime 90j, latence, séries
activeIncidentsIncidents ouverts (timeline updates)
recentIncidentsIncidents résolus récents

Polling

La page UI rafraîchit environ toutes les 60 s. Côté scripts, un intervalle de 1–5 minutes suffit ; évitez le spam. Les sondes côté API sont déjà debounce (~60 s) + cron.

Healthchecks (API & MCP)

Pour les probes Railway, Kubernetes ou un load balancer, préférez les endpoints santé dédiés (plus légers que la status page complète) :

ServiceEndpointRôle
APIGET /api/healthProcessus Nest up (liveness)
APIGET /api/readyAPI + Postgres prêts (readiness)
MCPGET /healthServeur MCP distant up
curl -X GET "https://api.njanggo.com/api/ready" \
  -H "Accept: application/json"

Ces checks alimentent aussi la status page (composants api, database, mcp).

Composants surveillés

CléGroupeCible typique
webPlatformhttps://njanggo.com/
apiPlatformhttps://api.njanggo.com/api/health
databasePlatformhttps://api.njanggo.com/api/ready
docsEdgehttps://docs.njanggo.com/
mcpEdgehttps://mcp.njanggo.com/health
pulseEdgehttps://pulse.njanggo.com/login

Stripe et Clerk ne sont pas sondés automatiquement (évite les faux négatifs auth). Un incident manuel peut toujours les signaler depuis Pulse.

MCP & intégrations

Avant de connecter Cursor, Claude ou un autre client à https://mcp.njanggo.com, vérifiez que le composant MCP est opérationnel sur la status page. L'outil njanggo_health interroge votre calendrier ; la status page indique si le serveur MCP lui-même est joignable.

Incidents

Les incidents visibles sur status.njanggo.com sont gérés en interne (Pulse). Les intégrateurs n'ont pas d'API d'écriture · lecture seule via la page ou GET /api/status/public.