API-Schlüssel

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Ihr API-Schlüssel sollte in den Anfrage-Headern enthalten sein.

API-Schlüssel-Header

Fügen Sie Ihren API-Schlüssel im x-api-key Header hinzu:

Anfragebash

curl -X GET "https://www.strompreise-schweiz.ch/api/v1/tariffs" \
  -H "x-api-key: YOUR_API_KEY"

Beispiel

JavaScriptjavascript

// JavaScript / Node.js
const response = await fetch('https://www.strompreise-schweiz.ch/api/v1/tariffs', {
  method: 'GET',
  headers: {
    'x-api-key': process.env.API_KEY,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Pythonpython

# Python
import requests

response = requests.get(
    'https://www.strompreise-schweiz.ch/api/v1/tariffs',
    headers={
        'x-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
)

data = response.json()
print(data)

API-Schlüssel erhalten

Um einen API-Schlüssel zu erhalten, müssen Sie:

Ein Konto auf Strompreise Schweiz erstellen
Zu Ihren Organisationseinstellungen navigieren
Zum Abschnitt API-Schlüssel gehen
Einen neuen API-Schlüssel generieren

Sicherheitsempfehlungen

Ihren API-Schlüssel niemals in clientseitigem Code oder öffentlichen Repositories exponieren
API-Schlüssel regelmässig rotieren
Umgebungsvariablen zur Speicherung von API-Schlüsseln verwenden
Jede Organisation sollte separate API-Schlüssel für verschiedene Anwendungen verwenden

Nicht autorisierte Antwort

Wenn Ihr API-Schlüssel ungültig oder fehlt, erhalten Sie eine 401-Antwort:

Antwortjson

{
  "success": false,
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}