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