L’API REST est versionnée sous /api/v1. Chaque requête métier est rattachée à une société et peut cibler explicitement un flux actif.
En-têtes principaux
| En-tête | Obligation | Rôle |
|---|---|---|
| X-Mystix-Company-Id | Oui en développement | Délimite la société |
| X-Mystix-Flow-Id | Selon l’opération | Sélectionne le flux |
| Idempotency-Key | Recommandé | Évite les doublons à la reprise |
| X-Request-Id | Automatique ou fourni | Corrèle les logs |
Exemple de contrôle de santé
curl https://edi.ma/api/actuator/healthErreur structurée
{
"errorCode": "FLOW_NOT_ACTIVE",
"stage": "RECEIVE",
"retryable": false,
"userMessage": "Le flux sélectionné n’est pas actif.",
"suggestedAction": "Activez le flux ou choisissez-en un autre."
}