openapi: 3.0.3
info:
  title: Meppo LLM API
  version: 1.0.0
  description: API für KI-Assistenten zur Suche nach freien Arztterminen in Deutschland.
servers:
  - url: https://www.meppo.de/api/v1/llm
paths:
  /search:
    post:
      summary: Suche freie Arzttermine
      operationId: searchDoctorAppointments
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/SearchRequest"
      responses:
        "200":
          description: Erfolgreiche Suche
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
  schemas:
    SearchRequest:
      type: object
      required: [specialty, location]
      properties:
        specialty:
          type: string
        location:
          type: string
        radius_km:
          type: number
        max_results:
          type: integer
