openapi: 3.0.0
info:
  title: hv2-api
  version: "1"
  description: "REST-API for the nober.de Hausverwaltungs-Software"
  termsOfService: "https://home.hottis.de/dokuwiki/doku.php?id=hv2pub:termsofuse"
  contact: "Wolfgang Hottgenroth <wolfgang.hottgenroth@icloud.com>"
externalDocs:
  description: "Find more details on this API here"
  url: "https://home.hottis.de/dokuwiki/doku.php?id=hv2pub:externaldocs"
server:
  url: "https://api.hv.nober.de/v1"

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