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.
Cette documentation s'adresse aux intégrateurs techniques qui connectent nAIxus à des systèmes externes : backends, applications web et clients mobiles.
Choisir son mode d'intégration
| Mode | À utiliser quand | Authentification |
|---|---|---|
| Canal API | Un backend, une application mobile ou un client natif appelle un flow (serveur-à-serveur avec nx_live_/nx_test_, ou client-à-serveur avec nx_pub_). | Authorization: Bearer nx_live_… ou nx_pub_… |
| API Widget | Un widget de chat s'exécute dans un navigateur sur un site client. | Clé publique nx_pub_… restreinte par origines autorisées |
Les deux modes exécutent un flow lié à un canal. Un canal se crée et se configure dans la console nAIxus ; voir Déployer un canal.
Commencer ici
- Prérequis d'intégration - credentials, environnements et checklist.
- Construire votre première intégration API channel - tutoriel de 20 minutes de la création du canal au premier appel.
- Référence d'API - contrat requête/réponse exhaustif, codes d'erreur et événements SSE.
Ce qu'il vous faut avant de commencer
- Un canal créé dans la console et lié à un flow publié.
- La clé d'API du canal (
nx_live_/nx_test_côté serveur,nx_pub_pour les widgets navigateur). - Pour les clés publiques : les origines autorisées configurées sur le canal.
Guides pratiques
| Objectif | Guide |
|---|---|
| Signer les requêtes avec HMAC | Signer les requêtes |
| Consommer un flux SSE | Recevoir les réponses en SSE |
| Reprendre une conversation | Reprendre une conversation |
| Renouveler une clé d'API ou un secret de signature | Renouveler les credentials |
| Déboguer les erreurs 401/403 | Dépannage |