APIs & Integration
Eine Erklärung zentral. Die exakte Runtime lokal.
Neleso.com beschreibt Zweck, Stabilität und Produktumfang der APIs. Im Ziel liefert jede Installation die OpenAPI-Spezifikation ihres eigenen Releases und eine lokale Swagger-Oberfläche. Community und Enterprise stellen beides bereits lokal bereit; der Standalone Broker folgt. Enterprise verwaltet API-Keys inzwischen im CPMS; nur noch nicht migrierte Account-, Audit- und Admin-Funktionen bleiben vorübergehend in einer lokalen Betriebsoberfläche.
Single Source
Produktcode erzeugt den Vertrag.
Im Ziel speist dieselbe versionierte OpenAPI-Spezifikation die zentrale Referenz und die lokale Swagger-Oberfläche. Kundendomains, Demo-Zugänge und produktionsspezifische Server gehören nicht in den öffentlichen Vertrag.
API-Katalog
Unterschiedliche Oberflächen, klar benannte Verträge.
Der Status bezeichnet hier einen veröffentlichten und unterstützten OpenAPI-Vertrag – nicht interne Routen. „Vertrag geplant“ ist daher keine bereits ausgelieferte öffentliche Schnittstelle.
| API | Broker | Community | Enterprise |
|---|---|---|---|
| Broker Control APIVerbindungen · Ziele · Routing | Vertrag geplant | Vertrag geplant | Vorhanden |
| OCPP Server APIStationen · Status · Kommandos | Vertrag geplant | Vertrag geplant | Vorhanden |
| CPMS Core APISessions · Tokens · Konfiguration | Vorhanden | Vorhanden | |
| Headless CPMS APIExterne Integrationsfläche | Vorhanden | ||
| Fleet & Driver APIsFlotte · Fahrer · Energie | Vorhanden |
Runtime Swagger
Lokale Entwicklerwerkzeuge bleiben bewusst erhalten.
Der konkrete Mount kann je Installation abweichen. Die Produktnavigation soll direkt auf die lokale Swagger-Ansicht verlinken; ein eigenes Login oder eine zweite Dokumentationsnavigation ist nicht erforderlich.
/api/docs/swagger-uiBroker, OCPP Server und CPMS Core – jeweils am betreffenden Dienst oder über den Installationsproxy.
Community-Swagger live öffnen →Enterprise-CPMS-Swagger öffnen →/api/docs/openapi.jsonRohe, maschinenlesbare Spezifikation für Generatoren, Tests und eigene Clients.
/docsHeadless CPMS verwendet heute diesen kürzeren Swagger-Pfad.
Enterprise-Headless-Swagger öffnen →Einige Enterprise-Oberflächen laden Assets heute noch von einem öffentlichen CDN. Die lokale Bündelung ist Teil der Produkt-Roadmap.
Ziel-Governance
Neue öffentliche Verträge sollen diese Regeln erfüllen.
Das ist die angestrebte Governance, keine rückwirkende Garantie für alle heutigen internen oder unversionierten Routen.
Versionierung
Neue öffentliche Pfade und Schemas werden einer benannten API-Version zugeordnet.
Authentifizierung
Externe APIs erhalten widerrufbare Schlüssel oder Bearer-Tokens mit den zum Produkt passenden Scopes.
Mandantengrenzen
Wo Mandantenfähigkeit gilt, wird der Kontext serverseitig aus der Identität abgeleitet.
Abkündigung
Künftig entfernte öffentliche Verträge sollen benannt, getestet und mit einem nachvollziehbaren Migrationspfad versehen werden.