Authentifizierung

Hi Walter nutzt API-Key-Authentifizierung. Jede Anfrage muss deinen API-Key als Bearer-Token im Authorization-Header enthalten.

Authorization: Bearer DEIN_API_KEY

API-Keys haben das Format hw_XXXXXXXXXXX.

API-Key erstellen

API-Keys werden in der Hi-Walter-App verwaltet: app.hiwalter.de.

1. Wähle „API-Key erstellen”.
2. Gib ihm einen Namen und klicke auf „Jetzt erstellen”.
3. Speichere deinen API-Key sofort sicher ab, er wird nur einmal angezeigt.

API-Key verwenden

Übergib den Key bei jeder Anfrage als Bearer-Token:

curl -X POST https://api.hiwalter.de/api/v1/tools/get_account \
  -H "Authorization: Bearer DEIN_API_KEY" \
  -H "Content-Type: application/json"

Konten-, Abrechnungs- und Nutzungs-Endpunkte (get_account, get_billing, get_usage) verbrauchen keine Credits, du kannst sie also jederzeit abfragen.

Sicherheit

• Behandle deinen API-Key wie ein Passwort und teile ihn niemals öffentlich.
• Gib Keys niemals im Frontend oder in öffentlichen Repositories preis.
• Kompromittierte Keys kannst du in der App widerrufen und neu erstellen.