146 lines
3.6 KiB
YAML
146 lines
3.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:
|
|
$ref: '#/components/schemas/patch_notes'
|
|
"400":
|
|
description: bad payload
|
|
get:
|
|
description: returns list of all Patch notes
|
|
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
|
|
tags:
|
|
- Patchnotes
|
|
x-openapi-router-controller: openapi_server.controllers.patchnotes_controller
|
|
/patchnotes/{patchID}:
|
|
put:
|
|
tags:
|
|
- Patchnotes
|
|
description: Updates one Patch
|
|
parameters:
|
|
- in: path
|
|
name: patchID
|
|
required: true
|
|
schema:
|
|
format: uuid
|
|
type: string
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/patch_notes'
|
|
responses:
|
|
"200":
|
|
description: patch updated
|
|
"404":
|
|
description: no patch found
|
|
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
|
|
/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
|
|
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
|
|
version: 1.0.0
|
|
date: 2025-01-02
|
|
properties:
|
|
patchID:
|
|
format: uuid
|
|
title: patchID
|
|
type: string
|
|
title:
|
|
type: string
|
|
title: title
|
|
changes:
|
|
type: string
|
|
title: changes
|
|
version:
|
|
type: string
|
|
title: version
|
|
patch_date:
|
|
title: patch_date
|
|
type: string
|
|
required:
|
|
- "title"
|
|
- "changes"
|
|
- "patch_date"
|
|
- "version"
|
|
user:
|
|
example:
|
|
lastSeenDate: 2025-01-02
|
|
properties:
|
|
lastSeenDate:
|
|
format: date
|
|
title: lastNoteChecked
|
|
type: string |