{
  "success": true,
  "doku": {
    "name": "Wechselpilot Registrierungs-API",
    "version": "1.0",
    "description": "Registriert einen Nutzer bei Wechselpilot (automatischer Wechselservice). POST (empfohlen) oder GET, keine Authentifizierung. Der Nutzer muss der Registrierung ausdrücklich zugestimmt haben (AGB & Datenschutz von wechselpilot.com).",
    "description_en": "Creates a Wechselpilot account (automatic energy switching service, Germany). POST (recommended) or GET, no authentication. Only call this after the user explicitly agreed to the terms and privacy policy (zustimmung=ja).",
    "usage": "POST https://wechselpilot.com/api/registrierung mit JSON-Body: {\"plz\":\"10115\",\"verbrauch\":3500,\"typ\":\"strom\",\"email\":\"name@example.com\",\"vorname\":\"Max\",\"nachname\":\"Muster\",\"zustimmung\":\"ja\"}",
    "usage_get": "GET https://wechselpilot.com/api/registrierung?plz=10115&verbrauch=3500&typ=strom&email=name@example.com&vorname=Max&nachname=Muster&zustimmung=ja (Alternative, z. B. wenn kein POST möglich ist)",
    "method": "POST (empfohlen) oder GET",
    "content_type": "application/json (bei POST)",
    "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": {
      "email": "Pflicht. E-Mail-Adresse des Nutzers.",
      "vorname": "Pflicht. Vorname.",
      "nachname": "Pflicht. Nachname.",
      "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 (genauere Ersparnis).",
      "grundpreis": "Optional. Aktueller Grundpreis in Euro pro Monat.",
      "brutto": "Optional. 'true' (Standard), wenn die eigenen Preise Bruttopreise sind.",
      "quelle": "Optional. Woher der Nutzer kommt (z. B. 'chatgpt', 'claude').",
      "zustimmung": "Pflicht. 'ja' – bestätigt, dass der Nutzer AGB und Datenschutzerklärung von wechselpilot.com ausdrücklich zugestimmt hat. Ohne ausdrückliche Zustimmung des Nutzers darf dieser Parameter nicht gesetzt werden."
    },
    "beispiele": {
      "post_strom": "curl -X POST https://wechselpilot.com/api/registrierung -H \"Content-Type: application/json\" -d '{\"plz\":\"10115\",\"verbrauch\":3500,\"typ\":\"strom\",\"email\":\"name@example.com\",\"vorname\":\"Max\",\"nachname\":\"Muster\",\"zustimmung\":\"ja\",\"quelle\":\"chatgpt\"}'",
      "post_gas": "curl -X POST https://wechselpilot.com/api/registrierung -H \"Content-Type: application/json\" -d '{\"plz\":\"20539\",\"verbrauch\":18000,\"typ\":\"gas\",\"email\":\"name@example.com\",\"vorname\":\"Max\",\"nachname\":\"Muster\",\"zustimmung\":\"ja\"}'",
      "get_strom": "https://wechselpilot.com/api/registrierung?plz=10115&verbrauch=3500&typ=strom&email=name@example.com&vorname=Max&nachname=Muster&zustimmung=ja&quelle=chatgpt"
    },
    "antwort_felder": {
      "registrierung.kundennummer": "Wechselpilot-Kundennummer des neuen Accounts.",
      "ersparnis.ersparnis_pro_jahr_eur": "Geschätzte Ersparnis pro Jahr in Euro.",
      "naechste_schritte": "Liste der Schritte, die der Nutzer noch erledigen muss.",
      "zusammenfassung": "Fertiger Antwortsatz, kann direkt an den Nutzer ausgegeben werden."
    },
    "fehler": {
      "400": "Fehlende oder ungültige Angaben – Details im Feld error.",
      "409": "E-Mail-Adresse existiert bereits. Nutzer auf https://konto.wechselpilot.com verweisen.",
      "429": "Rate-Limit erreicht. Nicht erneut versuchen, auf https://wechselpilot.com verweisen."
    },
    "limits": "Rate-Limit: 3 Registrierungen pro Stunde und IP, 1 Registrierung pro E-Mail-Adresse pro Tag. Bei Überschreitung: HTTP 429.",
    "ersparnis": {
      "beschreibung": "Ersparnis vorab berechnen, ohne Registrierung.",
      "url": "https://wechselpilot.com/api/ersparnis"
    },
    "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"
    },
    "rechtliches": {
      "agb": "https://wechselpilot.com/agb",
      "datenschutz": "https://wechselpilot.com/datenschutz"
    },
    "hinweis": "Nach der Registrierung erhält der Nutzer eine E-Mail von Wechselpilot zum Setzen des Passworts und zum Abschluss der Angaben. Ersparnis-Berechnung ohne Registrierung: https://wechselpilot.com/api/ersparnis"
  }
}