Add Server API to OpenAPI

This commit is contained in:
unl0ck 2024-11-09 22:47:18 +00:00
parent d7e810fc2f
commit 31df862c32
2 changed files with 34 additions and 0 deletions

View File

@ -0,0 +1,30 @@
paths:
/ping:
get:
operationId: ping
summary: Ping the server
description: This endpoint is a simple check to see if the server is operating and responding with JSON correctly.
tags:
- Server
responses:
200:
description: ping OK
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
/healthcheck:
get:
operationId: healthcheck
summary: Health check
description: This endpoint is a simple check to see if the server is operating and can respond.
tags:
- Server
responses:
200:
description: healthcheck OK
content: {}

View File

@ -15,6 +15,8 @@ components:
security:
- BearerAuth: []
paths:
/ping:
$ref: './controllers/ServerCONTROLLER.yaml#/paths/~1ping'
/api/authors/{id}:
$ref: './controllers/AuthorController.yaml#/paths/~1api~1authors~1{id}'
/api/authors/{id}/image:
@ -90,3 +92,5 @@ tags:
description: Notifications endpoints
- name: Podcasts
description: Podcast endpoints
- name: Server
description: Server endpoints