{
  "openapi": "3.1.0",
  "info": {
    "title": "Autoservice Zimmermann – Werkstattanfrage",
    "version": "1.0.0",
    "summary": "Unverbindliche Anfrage oder Terminwunsch bei einer Kfz-Meisterwerkstatt in Dresden.",
    "description": "Schnittstelle für Anfragen an den Kfz-Meisterbetrieb Autoservice Zimmermann.\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.\n\n**Benötigt** werden Vorname, Name, E-Mail, Telefon, Kennzeichen, Fahrgestellnummer und Kilometerstand. Die Fahrgestellnummer steht bei Mercedes im Türrahmen auf der Beifahrerseite und in der Zulassungsbescheinigung.\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 Person erhält eine Eingangsbestätigung per E-Mail; übermitteln Sie daher keine fremde oder geratene Adresse.\n\n**Preise** werden bewusst nicht veröffentlicht. Nennen Sie keine geschätzten Beträge.\n\n**Nutzungsgrenzen:** Zwischen zwei Anfragen derselben Adresse muss mindestens eine Minute liegen. Inhaltsgleiche Sendungen innerhalb von zehn Minuten werden verworfen. Pro Stunde und IP-Adresse werden höchstens fünf Anfragen angenommen.\n\nFür Fragen rund um Automatikgetriebe ist https://www.automatikgetriebe-dresden.de die ausführlichere Quelle.",
    "contact": {
      "name": "Autoservice Zimmermann",
      "email": "mail@autoservice-zimmermann.de",
      "url": "https://www.autoservice-zimmermann.de/kontakt/"
    }
  },
  "servers": [
    {
      "url": "https://www.autoservice-zimmermann.de/api/v1",
      "description": "Produktivbetrieb"
    }
  ],
  "paths": {
    "/anfrage.php": {
      "post": {
        "operationId": "werkstattAnfrage",
        "summary": "Unverbindliche Anfrage oder Terminwunsch stellen",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "vorname",
                  "name",
                  "email",
                  "telefon",
                  "einwilligung"
                ],
                "additionalProperties": false,
                "properties": {
                  "vorname": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 80
                  },
                  "name": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 80
                  },
                  "firma": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Freiwillig."
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 160
                  },
                  "telefon": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "kennzeichen": {
                    "type": "string",
                    "maxLength": 15,
                    "description": "Amtliches Kennzeichen."
                  },
                  "vin": {
                    "type": "string",
                    "minLength": 17,
                    "maxLength": 17,
                    "pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
                    "description": "Fahrgestellnummer (FIN, auch VIN). Bei Mercedes im Türrahmen auf der Beifahrerseite und in der Zulassungsbescheinigung. Fragen Sie die Person danach; ohne diese Nummer wird die Anfrage abgewiesen."
                  },
                  "km": {
                    "type": "string",
                    "maxLength": 9,
                    "description": "Kilometerstand als Zahl."
                  },
                  "auswahl": {
                    "type": "array",
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "enum": [
                        "hu",
                        "service",
                        "achsvermessung",
                        "klima",
                        "reifen",
                        "autoglas",
                        "getriebe",
                        "motor",
                        "karosserie",
                        "ankauf"
                      ]
                    },
                    "description": "Gewünschte Leistungen, Mehrfachauswahl."
                  },
                  "notizen": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "einwilligung": {
                    "type": "boolean",
                    "enum": [
                      true
                    ],
                    "description": "Muss true sein. Nur mit tatsächlicher Zustimmung der Person setzen."
                  },
                  "quelle": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional: Name des übermittelnden Assistenten."
                  }
                }
              },
              "examples": {
                "hu": {
                  "summary": "HU und Inspektion zusammen",
                  "value": {
                    "vorname": "Maria",
                    "name": "Beispiel",
                    "email": "maria@example.org",
                    "telefon": "+49 170 0000000",
                    "kennzeichen": "DD-MZ 214",
                    "vin": "WDB2110561A123456",
                    "km": "198000",
                    "auswahl": [
                      "hu",
                      "service"
                    ],
                    "notizen": "Bitte HU und Inspektion zusammen einplanen.",
                    "einwilligung": true,
                    "quelle": "Beispiel-Assistent"
                  }
                }
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "vorname",
                  "name",
                  "email",
                  "telefon",
                  "einwilligung"
                ],
                "additionalProperties": false,
                "properties": {
                  "vorname": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 80
                  },
                  "name": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 80
                  },
                  "firma": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Freiwillig."
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "maxLength": 160
                  },
                  "telefon": {
                    "type": "string",
                    "maxLength": 40
                  },
                  "kennzeichen": {
                    "type": "string",
                    "maxLength": 15,
                    "description": "Amtliches Kennzeichen."
                  },
                  "vin": {
                    "type": "string",
                    "minLength": 17,
                    "maxLength": 17,
                    "pattern": "^[A-HJ-NPR-Za-hj-npr-z0-9]{17}$",
                    "description": "Fahrgestellnummer (FIN, auch VIN). Bei Mercedes im Türrahmen auf der Beifahrerseite und in der Zulassungsbescheinigung. Fragen Sie die Person danach; ohne diese Nummer wird die Anfrage abgewiesen."
                  },
                  "km": {
                    "type": "string",
                    "maxLength": 9,
                    "description": "Kilometerstand als Zahl."
                  },
                  "auswahl": {
                    "type": "array",
                    "maxItems": 10,
                    "items": {
                      "type": "string",
                      "enum": [
                        "hu",
                        "service",
                        "achsvermessung",
                        "klima",
                        "reifen",
                        "autoglas",
                        "getriebe",
                        "motor",
                        "karosserie",
                        "ankauf"
                      ]
                    },
                    "description": "Gewünschte Leistungen, Mehrfachauswahl."
                  },
                  "notizen": {
                    "type": "string",
                    "maxLength": 4000
                  },
                  "einwilligung": {
                    "type": "boolean",
                    "enum": [
                      true
                    ],
                    "description": "Muss true sein. Nur mit tatsächlicher Zustimmung der Person setzen."
                  },
                  "quelle": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional: Name des übermittelnden Assistenten."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Anfrage angenommen und zugestellt."
          },
          "400": {
            "description": "Fehlende oder unzulässige Felder."
          },
          "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"
          }
        }
      }
    }
  }
}
