{
  "success": true,
  "doku": {
    "name": "Wechselpilot Ersparnis-API",
    "version": "1.0",
    "description": "Berechnet die geschätzte jährliche Ersparnis beim Strom- oder Gaswechsel mit Wechselpilot. Nur GET, keine Authentifizierung.",
    "description_en": "Estimates the annual savings when switching electricity or gas supplier with Wechselpilot (Germany). GET only, no authentication required.",
    "usage": "GET https://wechselpilot.com/api/ersparnis?plz=10115&verbrauch=3500&typ=strom",
    "method": "GET",
    "auth": "none",
    "cors": "Access-Control-Allow-Origin: * – der Endpunkt kann direkt aus Browser-Umgebungen (z. B. ChatGPT Canvas, Claude Artifacts, Web-Apps) per fetch() aufgerufen werden. Erlaubte Methoden: GET, POST, OPTIONS. Keine Cookies/Credentials nötig.",
    "parameters": {
      "plz": "Pflicht. Deutsche Postleitzahl, 5-stellig.",
      "verbrauch": "Pflicht. Jahresverbrauch in kWh (Strom z. B. 3500, Gas z. B. 20000).",
      "typ": "Optional. 'strom' (Standard) oder 'gas'.",
      "arbeitspreis": "Optional. Aktueller Arbeitspreis in Cent/kWh für eine genauere Berechnung.",
      "grundpreis": "Optional. Aktueller Grundpreis in Euro pro Monat.",
      "brutto": "Optional. 'true' (Standard), wenn die eigenen Preise Bruttopreise sind."
    },
    "beispiele": {
      "strom": "https://wechselpilot.com/api/ersparnis?plz=10115&verbrauch=3500&typ=strom",
      "gas": "https://wechselpilot.com/api/ersparnis?plz=20539&verbrauch=18000&typ=gas",
      "eigene_preise": "https://wechselpilot.com/api/ersparnis?plz=10115&verbrauch=3500&typ=strom&arbeitspreis=34.5&grundpreis=12.9"
    },
    "antwort_felder": {
      "eingabe.ort": "Ort zur PLZ.",
      "ergebnis.vergleichsbasis": "Grundversorgung oder eigene Preisangaben.",
      "ergebnis.aktuelle_jahreskosten_eur": "Jahreskosten der Vergleichsbasis in Euro.",
      "ergebnis.guenstigster_anbieter": "Name des günstigsten Anbieters.",
      "ergebnis.neue_jahreskosten_eur": "Jahreskosten des besten Tarifs in Euro.",
      "ergebnis.ersparnis_pro_jahr_eur": "Geschätzte Ersparnis pro Jahr in Euro.",
      "ergebnis.ersparnis_pro_monat_eur": "Geschätzte Ersparnis pro Monat in Euro.",
      "zusammenfassung": "Fertiger Antwortsatz, kann direkt an den Nutzer ausgegeben werden.",
      "wechseln": "Link zum Wechsel für die gewählte Energieart."
    },
    "limits": "Rate-Limit: 20 Anfragen pro Stunde und IP, 500 pro Stunde global. Bei HTTP 429 nicht erneut versuchen, sondern auf https://wechselpilot.com verweisen.",
    "registrierung": {
      "beschreibung": "Direkte Registrierung nach der Berechnung (nur mit ausdrücklicher Zustimmung des Nutzers, zustimmung=ja).",
      "url": "https://wechselpilot.com/api/registrierung"
    },
    "discovery": {
      "openapi": "https://wechselpilot.com/openapi.json",
      "ai_plugin": "https://wechselpilot.com/.well-known/ai-plugin.json",
      "agent_card": "https://wechselpilot.com/.well-known/agent.json",
      "mcp": "https://wechselpilot.com/.well-known/mcp.json",
      "llms_txt": "https://wechselpilot.com/llms.txt",
      "llms_txt_en": "https://wechselpilot.com/llms-full.txt",
      "doku": "https://wechselpilot.com/api"
    },
    "hinweis": "Ergebnis ist eine Schätzung. Zum Wechsel: https://wechselpilot.com (Strom) bzw. https://wechselpilot.com/gas."
  }
}