Clé API

Authentification

Toutes les requêtes API nécessitent une authentification avec une clé API. Votre clé API doit être incluse dans les en-têtes de la requête.

En-tête de clé API

Incluez votre clé API dans l'en-tête x-api-key:

Requêtebash

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

Exemple

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)

Obtenir une clé API

Pour obtenir une clé API, vous devez:

Créer un compte sur Strompreise Schweiz
Naviguer vers les paramètres de votre organisation
Aller à la section Clés API
Générer une nouvelle clé API

Bonnes pratiques de sécurité

Ne jamais exposer votre clé API dans le code côté client ou les dépôts publics
Effectuer une rotation périodique de vos clés API
Utiliser des variables d'environnement pour stocker les clés API
Chaque organisation devrait utiliser des clés API séparées pour différentes applications

Réponse non autorisée

Si votre clé API est invalide ou manquante, vous recevrez une réponse 401 :

Réponsejson

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