Bienvenue sur l'API AltherGo
AltherGo fournit une infrastructure de microservices robuste pour la gestion de la mobilité électrique (e-mobility). Notre architecture a été conçue selon des normes strictes d'évolutivité et de résilience, interconnectant les conducteurs, le matériel (EVSE) et les systèmes de règlement financier dans un écosystème événementiel à haute disponibilité.
L'architecture de communication matérielle adhère strictement aux protocoles OCPP 1.6-J et OCPP 2.0.1, garantissant la conformité aux normes européennes et une compatibilité mondiale avec de multiples fabricants de bornes de recharge.
Piliers de l'Architecture
La plateforme est divisée en couches de services indépendantes pour garantir la stabilité et l'isolement des données :
- Passerelle de Protocole (OCPP) : Gère les connexions WebSocket persistantes et utilise un bus de messages MQTT pour acheminer la télémétrie et les commandes techniques en temps réel.
- Moteur Financier (Financial Engine) : Orchestre les paiements, les portefeuilles numériques (Wallets) et les intégrations avec la passerelle Pagar.me V5 dans un environnement isolé et sécurisé.
- Workers Événementiels (Event-Driven) : Traitement asynchrone via BullMQ pour garantir l'intégrité des remboursements, des notifications et de la synchronisation des bases de données.
- Tableau de Bord B2B : Interface de gestion pour les opérateurs (CPO) avec analyse de la consommation et gestion multi-locataires des flottes d'entreprise.
Capacités de la Plateforme
Grâce à nos endpoints RESTful, les intégrateurs et les partenaires peuvent :
- Gestion de l'Infrastructure : Enregistrement des stations physiques, cartographie des connecteurs et application d'hypothèses de coûts dynamiques.
- Orchestration des Recharges : Déclenchement de commandes à distance, surveillance instantanée de la télémétrie de consommation et application de profils de Smart Charging.
- Règlement Financier : Capture de transactions par carte de crédit ou PIX, gestion des soldes numériques et application automatique des règles de Cashback.
- Administration des Utilisateurs : Contrôle granulaire des permissions via des étiquettes (Tags) et des groupes d'utilisateurs pour la gestion de flotte.
Sécurité et Authentification
La sécurité est le pilier central de notre infrastructure. Nous mettons en œuvre des normes modernes pour assurer l'intégrité des transactions monétaires et des données matérielles sensibles.
La plupart des routes mutables exigent un jeton JWT valide envoyé dans l'en-tête de la requête. Le système garantit une isolation stricte des données par entreprise (Company Isolation) :
Authorization: Bearer <votre_jeton_jwt>
Structure de la Documentation
Utilisez le menu latéral pour explorer les domaines de service. Nous vous recommandons de commencer par la section Infrastructure pour comprendre la connectivité avec les chargeurs, ou par la section Règlement Financier pour configurer les flux de paiement de votre réseau.