Bem-vindo à AltherGo API

A AltherGo fornece uma infraestrutura robusta de microsserviços para a gestão de mobilidade elétrica (e-mobility). A nossa arquitetura foi desenhada sob rígidos padrões de escalabilidade e resiliência, interligando condutores, hardware (EVSEs) e sistemas de liquidação financeira num ecossistema de alta disponibilidade orientado a eventos.

Certificação e Conformidade

A arquitetura de comunicação com o hardware é estritamente aderente aos protocolos OCPP 1.6-J e OCPP 2.0.1, garantindo conformidade com normas europeias e compatibilidade global com múltiplos fabricantes de estações de carregamento.

Pilares da Arquitetura

A plataforma é dividida em camadas de serviço independentes para garantir a estabilidade e o isolamento de dados:

1. Protocol Gateway (OCPP): Gere conexões WebSocket persistentes e utiliza um barramento de mensagens MQTT para rotear telemetria e comandos técnicos em tempo real.
2. Financial Engine: Orquestra pagamentos, carteiras digitais (Wallets) e integrações com o gateway Pagar.me V5 num ambiente isolado e seguro.
3. Event-Driven Workers: Processamento assíncrono via BullMQ para garantir a integridade de estornos, notificações e sincronismo entre bases de dados.
4. B2B Dashboard: Interface de gestão para operadores (CPOs) com análise de consumo e gestão de frotas corporativas multi-tenant.

Capacidades da Plataforma

Através dos nossos endpoints RESTful, integradores e parceiros podem:

• Gestão de Infraestrutura: Registo de estações físicas, mapeamento de conectores e aplicação de premissas de custo dinâmico.
• Orquestração de Recargas: Acionamento de comandos remotos, monitorização de telemetria de consumo instantânea e aplicação de perfis de Smart Charging.
• Liquidação Financeira: Captura de transações com cartões ou PIX, gestão de saldos digitais e aplicação automática de regras de Cashback.
• Administração de Utilizadores: Controlo de permissões granulares via etiquetas (Tags) e grupos de utilizadores para gestão de frotas.

Segurança e Autenticação

A segurança é o pilar central da nossa infraestrutura. Implementamos padrões modernos para assegurar a integridade das transações monetárias e dos dados sensíveis de hardware.

Autenticação e Escopo

A maioria das rotas mutáveis exige um token JWT válido enviado no cabeçalho da requisição. O sistema garante o isolamento estrito de dados por empresa (Company Isolation): Authorization: Bearer <seu_token_jwt>

Estrutura da Documentação

Utilize o menu lateral para explorar os domínios de serviço. Recomendamos iniciar pela secção de Infraestrutura para compreender a conectividade com os carregadores, ou pela secção de Liquidação Financeira para configurar os fluxos de pagamento da sua rede.