openapi: 3.0.3
info:
  title: AlleZulassungen API
  description: Neuzulassungs- und Marktdaten für Pkw (Deutschland und Europa).
  version: 1.0.0
servers:
  - url: https://api.allezulassungen.de/api/v1
  - url: http://localhost:8080/api/v1
paths:
  /marken:
    get:
      summary: Liste aller Marken
      parameters:
        - name: land
          in: query
          schema: { type: string, example: DE }
        - name: limit
          in: query
          schema: { type: integer }
      responses:
        '200':
          description: Liste der Marken
  /marken/{slug}:
    get:
      summary: Marke nach Slug
      parameters:
        - name: slug
          in: path
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Markendetails
  /modelle/{slug}:
    get:
      summary: Modell nach Slug
      parameters:
        - name: slug
          in: path
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Modelldetails
  /statistik/top:
    get:
      summary: Top Marken/Modelle
      parameters:
        - name: land
          in: query
          schema: { type: string }
        - name: typ
          in: query
          schema: { type: string, enum: [marken, modelle] }
        - name: limit
          in: query
          schema: { type: integer }
      responses:
        '200':
          description: Top-Liste
  /statistik/uebersicht:
    get:
      summary: Marktübersicht
      parameters:
        - name: land
          in: query
          schema: { type: string }
      responses:
        '200':
          description: Übersichtszahlen
  /vergleich:
    get:
      summary: Vergleich Zeitreihen
      parameters:
        - name: land
          in: query
          schema: { type: string }
        - name: typ
          in: query
          schema: { type: string, enum: [marken, modelle] }
        - name: ids
          in: query
          schema: { type: string }
        - name: slugs
          in: query
          schema: { type: string }
      responses:
        '200':
          description: Vergleichsdaten