Prérequis d'intégration
Prérequis, identifiants, environnements et exigences réseau avant d'intégrer nAIxus.
Avant d'écrire du code d'intégration, vérifiez les points suivants.
Prérequis
- Un flow publié. Le flow que vous appelez doit être publié (pas seulement en brouillon).
- Un canal lié à ce flow. Les intégrations exécutent un canal, pas un flow directement. Créez et liez le canal dans la console - voir Déployer un canal.
- Une clé d'API émise pour ce canal.
Identifiants
| Préfixe de clé | Où elle s'exécute | Confidentialité |
|---|---|---|
nx_live_ | Côté serveur, production | Secrète - ne jamais exposer côté client |
nx_test_ | Côté serveur, hors production | Secrète - ne jamais exposer côté client |
nx_pub_ | Widget navigateur | Publique, mais restreinte aux origines autorisées |
Les clés sont émises et renouvelées depuis le canal dans la console. Décidez qui gère la rotation avant la mise en production.
Environnements
| Environnement | Clé | Usage |
|---|---|---|
| Développement / Staging | nx_test_… | Construire et valider l'intégration |
| Production | nx_live_… | Trafic réel des utilisateurs finaux |
Ne testez pas avec une clé de production (nx_live_) : les exécutions de production sont facturées et journalisées.
Exigences réseau
- HTTPS vers l'origine du service Core.
- Le système appelant doit pouvoir joindre l'origine du service Core.
- Les widgets navigateur envoient un en-tête
Origin; cette origine doit figurer dans la liste des origines autorisées du canal.
Valider votre configuration
- Vérifiez que le canal est actif et lié à un flow publié.
- Appelez
POST /public/v1/api/executeavec unpayloadminimal. - Attendez
200 OKavec unrun_idetstatus: "success".
Si vous recevez 409, le canal est inactif ou le flow n'a pas de version publiée. Si vous recevez 404, le canal n'est pas lié à un flow.
Voir aussi
Documentation intégrateur
Connectez des systèmes externes à nAIxus via le canal API - choisissez votre mode d'intégration, réunissez les prérequis et appelez le contrat d'API.
Construire votre première intégration API
Tutoriel - connecter un service backend à un flow nAIxus via le canal API. Un parcours complet de la création du canal à la réponse JSON et au streaming.