Documentation Développeurs
Les API Wogeez
Ce que l'API permet, comment s'y connecter et où trouver la référence complète.
Ce que permet l'API
Les fonctions du manager, pour vos logiciels.
L'API REST de Wogeez expose les mêmes fonctions que le manager. Vos logiciels peuvent lire l'état du parc, le modifier et réagir à ce qui s'y passe, par exemple pour alimenter votre supervision, votre outil de ticketing ou votre système de caisse.
Pour commencer, suivez les tutoriels Lister les bornes d'une entreprise puis Envoyer une commande à une borne.
Ressources
Rechercher, consulter et modifier les bornes, scénarios et cartes SIM, avec vos propres identifiants métier.
Commandes
Envoyer une commande à un équipement d'une borne, comme depuis le manager, et suivre son résultat.
Parcours clients
Récupérer le snapshot d'un parcours, avec les saisies et le résultat de chaque étape.
S'authentifier
Un jeton OpenID Connect à chaque appel.
L'API utilise des jetons OpenID Connect, délivrés par le serveur d'authentification Wogeez à partir d'un compte de la plateforme. C'est le même compte que pour les applications, grâce à l'authentification unique.
Le jeton accompagne chaque appel dans l'en-tête Authorization. Sa durée de vie est courte, votre intégration le renouvelle donc régulièrement.
curl https://api-v2.wogeez.com/companies -H "Authorization: Bearer <jeton>"Cet appel liste les entreprises auxquelles votre compte a accès. C'est le plus simple pour vérifier qu'une intégration fonctionne.
Être prévenu sans interroger l'API
Les webhooks.
Un webhook appelle votre serveur dès qu'un événement se produit, sans que vous ayez à interroger l'API en continu. Il se déclenche aujourd'hui à chaque fois qu'une borne remonte l'état de santé de son matériel, ou à la fin d'un scénario avec tout le contexte du parcours.
Les envois en échec sont retentés automatiquement, et des en-têtes personnalisés permettent de vérifier que l'appel vient bien de Wogeez. Tutoriel: recevoir les événements par webhook
Les assistants et agents IA
Le serveur MCP.
Le serveur MCP Wogeez ouvre le parc aux assistants IA comme Le Chat de Mistral AI et à vos propres agents. Ils interrogent et pilotent les bornes avec les droits de l'utilisateur connecté, et demandent son accord avant d'agir. Connecter un assistant IA
Référence et accompagnement
Où trouver le détail.
La liste complète des points d'accès est publique dans le Swagger, qui permet aussi d'essayer les appels une fois connecté. La spécification OpenAPI s'importe directement dans Postman.
Les guides d'intégration détaillés, le format des scénarios et les exemples vous sont présentés pendant notre travail commun, sur un espace partagé avec vos équipes. Parlons de votre projet