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.
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.
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 quand l'état de santé d'un équipement change, 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.
Les assistants et agents IA
Le serveur MCP.
Le serveur MCP Wogeez ouvre le parc aux assistants IA comme ChatGPT et à vos propres agents. Ils interrogent et pilotent les bornes avec les droits de l'utilisateur connecté, et demandent son accord avant d'agir. Découvrir l'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