47 lines
1.1 KiB
YAML
47 lines
1.1 KiB
YAML
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:
|
|
'application/json':
|
|
schema:
|
|
$ref: '#/components/schemas/TestOutput'
|
|
security:
|
|
- jwt: ['secret']
|
|
|
|
|
|
components:
|
|
securitySchemes:
|
|
jwt:
|
|
type: http
|
|
scheme: bearer
|
|
bearerFormat: JWT
|
|
x-bearerInfoFunc: auth.decodeToken
|
|
schemas:
|
|
TestOutput:
|
|
description: Test Output
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
details:
|
|
type: object
|