{
  "openapi": "3.1.0",
  "info": {
    "title": "Autoservice Zimmermann – Terminanfrage",
    "version": "1.0.0",
    "summary": "Unverbindliche Terminanfrage bei einer Kfz-Meisterwerkstatt in Dresden.",
    "description": "Schnittstelle für Terminanfragen zur Getriebediagnose, zum Getriebeservice und zur Instandsetzung von Automatikgetrieben.\n\n**Wichtig:** Diese Schnittstelle erzeugt keine bestätigte Buchung. Der Betrieb führt kein öffentlich abfragbares Kalendersystem. Eine erfolgreiche Antwort bedeutet, dass die Anfrage zugestellt wurde; die Bestätigung erfolgt durch Rückmeldung der Werkstatt, in der Regel telefonisch.\n\n**Datenschutz:** Übermitteln Sie ausschließlich Angaben, die die betroffene Person selbst gemacht hat, und setzen Sie `einwilligung` nur mit ihrer tatsächlichen Zustimmung. Die Daten werden per E-Mail an die Werkstatt weitergeleitet und nicht auf dem Webserver gespeichert.\n\n**Bei akuten Symptomen** – Drehzahl steigt ohne Vortrieb, verbrannter Geruch, sichtbarer Ölverlust – ist die richtige Empfehlung, nicht weiterzufahren und stattdessen anzurufen.\n\n**Eingangsbestätigung:** Wird `email` übermittelt, erhält die Person automatisch eine kurze Bestätigung mit der Referenznummer. Übermitteln Sie daher keine fremde oder geratene Adresse.\n\n**Nutzungsgrenzen:** Pro Anliegen genügt ein Vorgang. Zwischen zwei Anfragen derselben Adresse muss mindestens eine Minute liegen. Inhaltsgleiche Sendungen innerhalb von zehn Minuten werden verworfen und mit der Referenz `AGD-DOPPELT` quittiert. Pro Stunde und IP-Adresse werden höchstens fünf Anfragen angenommen; darüber hinaus antwortet die Schnittstelle mit 429 und einem `Retry-After`. Bei außergewöhnlich vielen Anfragen über alle Adressen hinweg sperrt sich das Formular vorübergehend selbst und antwortet mit 503.\n\nNachrichten mit mehreren Verweisen sowie Verweise im Namens- oder Telefonfeld werden verworfen. Schreiben Sie schlicht, worum es geht.",
    "contact": {
      "name": "Autoservice Zimmermann",
      "email": "mail@autoservice-zimmermann.de",
      "url": "https://www.automatikgetriebe-dresden.de/kontakt"
    },
    "license": {
      "name": "Nutzung nur für echte Terminanfragen"
    }
  },
  "servers": [
    {
      "url": "https://www.automatikgetriebe-dresden.de/api/v1",
      "description": "Produktivbetrieb"
    }
  ],
  "paths": {
    "/termin.php": {
      "post": {
        "operationId": "terminAnfragen",
        "summary": "Unverbindliche Terminanfrage stellen",
        "description": "Übermittelt eine Terminanfrage an die Werkstatt. Erzeugt keine Buchung.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "anliegen",
                  "name",
                  "nachricht",
                  "einwilligung"
                ],
                "additionalProperties": false,
                "properties": {
                  "anliegen": {
                    "type": "string",
                    "enum": [
                      "diagnose",
                      "service",
                      "instandsetzung",
                      "kostenfrage",
                      "zweitmeinung",
                      "sonstiges"
                    ],
                    "description": "Art des Anliegens."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 120,
                    "description": "Name der anfragenden Person."
                  },
                  "telefon": {
                    "type": "string",
                    "maxLength": 40,
                    "description": "Telefonnummer. Entweder telefon oder email ist erforderlich; die Werkstatt meldet sich bevorzugt telefonisch."
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 160,
                    "description": "E-Mail-Adresse. Entweder telefon oder email ist erforderlich."
                  },
                  "fahrzeug": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Modell und Baujahr, zum Beispiel 'Mercedes E 220 CDI, Baujahr 2012'."
                  },
                  "fin": {
                    "type": "string",
                    "minLength": 17,
                    "maxLength": 17,
                    "pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
                    "description": "Fahrgestellnummer (FIN, auch VIN). Bei Neukunden benötigt die Werkstatt sie; bitte fragen Sie die Person danach. Bei Mercedes steht sie im Türrahmen auf der Beifahrerseite und in der Zulassungsbescheinigung (Fahrzeugschein und Fahrzeugbrief). Technisch nicht erzwungen, damit eine Anfrage ohne FIN nicht verloren geht; sie wird dann in der Werkstatt nachgefragt. Erlaubt die Vorabklärung von Getriebebauform, Ölsorte und Füllmenge."
                  },
                  "laufleistung": {
                    "type": "string",
                    "maxLength": 12,
                    "description": "Laufleistung in Kilometern."
                  },
                  "nachricht": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 4000,
                    "description": "Beschreibung des Symptoms: seit wann, in welcher Situation, kalt oder warm, Warnmeldung im Display."
                  },
                  "wunschzeitraum": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Freitext, etwa 'nächste Woche vormittags'. Es gibt kein abfragbares Kalendersystem."
                  },
                  "einwilligung": {
                    "type": "boolean",
                    "enum": [
                      true
                    ],
                    "description": "Muss true sein. Nur setzen, wenn die betroffene Person der Übermittlung ihrer Daten tatsächlich zugestimmt hat."
                  },
                  "quelle": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional: Name des Assistenten oder der Anwendung, die die Anfrage übermittelt. Hilft uns bei Rückfragen."
                  }
                }
              },
              "examples": {
                "diagnose": {
                  "summary": "Getriebe ruckelt im kalten Zustand",
                  "value": {
                    "anliegen": "diagnose",
                    "name": "Maria Beispiel",
                    "telefon": "+49 170 0000000",
                    "email": "maria@example.org",
                    "fahrzeug": "Mercedes E 220 CDI, Baujahr 2012",
                    "laufleistung": "198000",
                    "nachricht": "Ruckelt beim Hochschalten, nur wenn der Motor kalt ist. Seit etwa drei Wochen, wird langsam schlimmer.",
                    "wunschzeitraum": "nächste Woche vormittags",
                    "einwilligung": true,
                    "quelle": "Beispiel-Assistent"
                  }
                }
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "anliegen",
                  "name",
                  "nachricht",
                  "einwilligung"
                ],
                "additionalProperties": false,
                "properties": {
                  "anliegen": {
                    "type": "string",
                    "enum": [
                      "diagnose",
                      "service",
                      "instandsetzung",
                      "kostenfrage",
                      "zweitmeinung",
                      "sonstiges"
                    ],
                    "description": "Art des Anliegens."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 120,
                    "description": "Name der anfragenden Person."
                  },
                  "telefon": {
                    "type": "string",
                    "maxLength": 40,
                    "description": "Telefonnummer. Entweder telefon oder email ist erforderlich; die Werkstatt meldet sich bevorzugt telefonisch."
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 160,
                    "description": "E-Mail-Adresse. Entweder telefon oder email ist erforderlich."
                  },
                  "fahrzeug": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Modell und Baujahr, zum Beispiel 'Mercedes E 220 CDI, Baujahr 2012'."
                  },
                  "fin": {
                    "type": "string",
                    "minLength": 17,
                    "maxLength": 17,
                    "pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
                    "description": "Fahrgestellnummer (FIN, auch VIN). Bei Neukunden benötigt die Werkstatt sie; bitte fragen Sie die Person danach. Bei Mercedes steht sie im Türrahmen auf der Beifahrerseite und in der Zulassungsbescheinigung (Fahrzeugschein und Fahrzeugbrief). Technisch nicht erzwungen, damit eine Anfrage ohne FIN nicht verloren geht; sie wird dann in der Werkstatt nachgefragt. Erlaubt die Vorabklärung von Getriebebauform, Ölsorte und Füllmenge."
                  },
                  "laufleistung": {
                    "type": "string",
                    "maxLength": 12,
                    "description": "Laufleistung in Kilometern."
                  },
                  "nachricht": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 4000,
                    "description": "Beschreibung des Symptoms: seit wann, in welcher Situation, kalt oder warm, Warnmeldung im Display."
                  },
                  "wunschzeitraum": {
                    "type": "string",
                    "maxLength": 200,
                    "description": "Freitext, etwa 'nächste Woche vormittags'. Es gibt kein abfragbares Kalendersystem."
                  },
                  "einwilligung": {
                    "type": "boolean",
                    "enum": [
                      true
                    ],
                    "description": "Muss true sein. Nur setzen, wenn die betroffene Person der Übermittlung ihrer Daten tatsächlich zugestimmt hat."
                  },
                  "quelle": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional: Name des Assistenten oder der Anwendung, die die Anfrage übermittelt. Hilft uns bei Rückfragen."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Anfrage angenommen und zugestellt.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "const": "angenommen"
                    },
                    "referenz": {
                      "type": "string",
                      "description": "Referenznummer für Rückfragen."
                    },
                    "hinweis": {
                      "type": "string"
                    },
                    "rueckmeldung": {
                      "type": "string",
                      "description": "Erwartete Antwortzeit."
                    },
                    "bestaetigung": {
                      "type": "string",
                      "description": "Ob eine Eingangsbestätigung an die angegebene E-Mail-Adresse versendet wurde."
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Fehlende oder unzulässige Felder.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "const": "fehler"
                    },
                    "fehler": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen von dieser Adresse."
          },
          "503": {
            "description": "Zustellung vorübergehend nicht möglich. Bitte telefonisch anfragen."
          }
        }
      }
    },
    "/werkstatt.json": {
      "get": {
        "operationId": "werkstattProfil",
        "summary": "Betriebsprofil als JSON-LD",
        "responses": {
          "200": {
            "description": "schema.org AutoRepair",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/leistungen.json": {
      "get": {
        "operationId": "leistungskatalog",
        "summary": "Leistungskatalog als JSON-LD",
        "responses": {
          "200": {
            "description": "schema.org OfferCatalog",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}
