Announcement_Service/announcement_service_spec.yaml

103 lines
2.6 KiB
YAML

openapi: 3.0.3
info:
title: announcementService
description: Announcing patchnotes for KanzleiApp
version: 1.0.0
paths:
/patchnotes:
post:
tags:
- Patchnotes
description: creates new Patch notes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/patch_notes'
responses:
"200":
description: game created
content:
application/json:
schema:
items:
$ref: '#/components/schemas/patch_notes'
/patchnotes/{patchID}:
delete:
tags:
- Patchnotes
description: deletes one Patch note
parameters:
- in: path
name: patchID
required: true
schema:
format: uuid
type: string
style: simple
responses:
"200":
description: patch successfully deleted
"404":
description: patch not found
"500":
description: Internal Server Error, Patch not deleted
/patchnotes/{date}:
get:
description: returns list of all unseen Patch notes from the user
parameters:
- explode: false
in: path
name: date
required: true
schema:
format: date
type: string
style: simple
example: 2025-01-02
responses:
"200":
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/patch_notes'
description: returns list of all unseen Patch notes from the user
"404":
description: no Patch notes found
"500":
description: "Internal Server error, Failed to get Patch Notes"
tags:
- Patchnotes
x-openapi-router-controller: openapi_server.controllers.patchnotes_controller
components:
schemas:
patch_notes:
example:
patchID: 29e80bcc-5981-4a52-99e1-373442dea9b9
title: Patch note 1
changes: changes
date: 2025-01-02
properties:
patchID:
format: uuid
title: patchID
type: string
title:
type: string
title: title
changes:
type: string
title: changes
date:
title: date
type: string
user:
example:
lastSeenDate: 2025-01-02
properties:
lastSeenDate:
format: date
title: lastNoteChecked
type: string