API-Key

API Key für PFM / PFM-HKN Integrationen

Mit einem persönlichen API Key können Sie Daten aus EVU-Solutions direkt in Excel, Generis oder andere externe Tools laden, ohne sich jedes Mal neu anzumelden. Der Key ist Ihrem Benutzerkonto zugeordnet und kann jederzeit rotiert oder deaktiviert werden.

1. API Key generieren

Klicken Sie oben rechts auf Ihren Benutzernamen und öffnen Sie Profil verwalten.
Wählen Sie im Seitenmenü den Punkt API Key.
Klicken Sie auf API Key generieren.
Der vollständige Key wird im Feld angezeigt. Mit dem Kopier-Symbol rechts neben dem Feld wird er in die Zwischenablage übernommen (grüne Bestätigung „API Key kopiert“ erscheint).

2. Key rotieren oder deaktivieren

Neuen Key generieren – Erzeugt einen neuen Key, der alte wird sofort ungültig. Alle Integrationen müssen mit dem neuen Wert aktualisiert werden.
Deaktivieren – Entfernt Ihren Key vollständig. Alle Integrationen verlieren den Zugriff, bis ein neuer Key generiert wird.

3. Verwendung in Excel (Daten vom Web)

Öffnen Sie im Designer (PFM oder PFM-HKN) das gewünschte Favorit/Report.
Kopieren Sie über URL kopieren die API-URL des Favoriten (Sie erhalten eine URL auf /csv-data-api oder /excel-data-api).
In Excel: Daten → Aus dem Web, URL einfügen.
Wählen Sie als Authentifizierung Basic:
- Benutzername: beliebig (z. B. apikey)
- Passwort: Ihr API Key
Verbindung speichern – Excel ruft die Daten ab und aktualisiert sie auf Wunsch automatisch.

4. Alternativ: Header oder Query-Parameter

Tools, die Basic Auth nicht unterstützen, können den Key auch direkt mitschicken:

Header: x-api-key: <Ihr Key>
Query: ?ApiKey=<Ihr Key>

5. Sicherheit & Hinweise

Der Key ist persönlich – nicht weitergeben, nicht in geteilten Dateien speichern.
Bei Verdacht auf Kompromittierung: sofort Neuen Key generieren klicken (alter Key wird ungültig).
Nach 25 fehlgeschlagenen Authentifizierungsversuchen wird Ihre IP für 15 Minuten gesperrt. Wenn das passiert: 15 Minuten warten, dann mit dem korrekten Key erneut versuchen.