openapi: 3.0.0
info:
  title: hv2-api
  version: "1"
  description: "REST-API for the Nober Grundbesitz GbR Hausverwaltungs-Software"
  termsOfService: "https://home.hottis.de/dokuwiki/doku.php?id=hv2pub:termsofuse"
  contact: 
    name: "Wolfgang Hottgenroth"
    email:  "wolfgang.hottgenroth@icloud.com"
externalDocs:
  description: "Find more details here"
  url: "https://home.hottis.de/dokuwiki/doku.php?id=hv2pub:externaldocs"

paths:
  /v1/test:
    get:
      tags: [ "Test" ]
      summary: Return secret string
      operationId: auth.testToken
      responses:
        '200':
          description: secret response
          content:
            'text/plain':
              schema:
                type: string
      security:
      - jwt: ['secret']


components:
  securitySchemes:
    jwt:
      type: http
      scheme: bearer
      bearerFormat: JWT
      x-bearerInfoFunc: auth.decodeToken