Intégration REST : déclencher le rapprochement depuis vos systèmes

Vue stylisée : requête POST vers l’API session, réponse immédiate ou mise en file selon la configuration.

Ce guide s’adresse aux équipes techniques qui enchaînent la clôture avec des jobs automatiques. Il décrit comment lancer une exécution de matching pour une session déjà créée dans Ninon, sans reprendre le parcours métier du tableau de bord.

Authentification

Deux modes : session utilisateur avec un rôle autorisé à agir sur la session (admin ou member du groupe ; le rôle viewer est refusé pour cet endpoint), ou appel machine avec l’en-tête Authorization: Bearer suivi du secret configuré côté serveur Ninon dans la variable d’environnement RECONCILIATION_MATCH_RUN_SECRET. L’identifiant dans l’URL doit être une session appartenant à votre organisation.

Déclencher un run

Méthode POST. Chemin /api/reconciliation/[sessionId]/run — remplacez [sessionId] par l’UUID de la session (celui du tableau de bord). Le corps de la requête peut être vide.

Réponses HTTP

Lorsque INNGEST_EVENT_KEY est défini sur l’instance et que vous ne forcez pas le mode synchrone, la réponse est HTTP 202 avec queued: true et des identifiants d’événements Inngest. Sinon le traitement s’exécute dans la requête : HTTP 200 avec queued: false et des statistiques. Pour forcer l’exécution synchrone même avec Inngest, utilisez le paramètre ?sync=1 ou l’en-tête x-sync-matching: true. Sans clé Inngest, le comportement reste synchrone (200).

Workers Inngest

Les déploiements qui traitent les événements via Inngest exposent POST /api/inngest pour les workers Inngest (configuration d’hébergement). C’est distinct de l’appel métier qui lance un run sur une session.