Skip to main content
NEXCLARADocumentation

Schemas: health

Schemas whose first using operation belongs to the health family. A shared schema is described once, here, and linked from every operation that uses it.

Descriptions come from the contract, which is written in French. They are reproduced verbatim so that the contract remains the source of truth.

DependencyState

Etat d'une dependance de fondation.

Type : object

PropertyTypeRequiredDescriptionConstraints
error_codestring | nullnoCode d'erreur stable si la sonde a echoue.
latency_msnumberyesDuree de la sonde en millisecondes.
namestringyesNom technique de la dependance.
status"up" | "down"yesDisponibilite observee.

Used by : healthReady

Environment

Environnements d'execution reconnus (Revision 1, section 8.1).

Type : string

Allowed values : local, shared_dev, staging, production

Used by : serviceVersion

LivenessResponse

Reponse de la sonde de vivacite.

Type : object

PropertyTypeRequiredDescriptionConstraints
environmentstringyesEnvironnement declare par la configuration.
revisionstring | nullyesRevision Git de l'artefact deploye ; null hors deploiement.
servicestringyesNom technique du service.
status"alive"yesLe processus API repond.
versionstringyesVersion du paquet API.

Used by : healthLive

ReadinessResponse

Reponse de la sonde d'aptitude au trafic.

Type : object

PropertyTypeRequiredDescriptionConstraints
dependenciesarray<DependencyState>yesEtat de chaque dependance de fondation reellement interrogee.
revisionstring | nullyesRevision Git de l'artefact deploye ; null hors deploiement.
servicestringyesNom technique du service.
status"ready" | "not_ready"yesAptitude globale du service.
versionstringyesVersion du paquet API.

Used by : healthReady

VersionResponse

Version servie : produit, revision, environnement, contrat, moteur.

Type : object

PropertyTypeRequiredDescriptionConstraints
api_versionstringyesVersion majeure du contrat d'API, celle du chemin.
engine_versionstring | nullyesVersion du moteur de decision enregistree avec chaque evaluation ; null pour CONTROL, qui n'execute pas le moteur.
environmentEnvironmentyesEnvironnement declare par la configuration.
revisionstring | nullyesSHA Git abrege (12 caracteres) de l'artefact deploye ; null hors deploiement.
versionstringyesVersion produit (SemVer), source unique : fichier racine VERSION.

Used by : serviceVersion