Public API: Cleanup history schemas

Signed-off-by: David Mehren <git@herrmehren.de>
Co-authored-by: Yannick Bungers <git@innay.de>
This commit is contained in:
David Mehren 2020-10-24 19:39:34 +02:00
parent cfe8169fc2
commit b7195c563c
No known key found for this signature in database
GPG key ID: 185982BA4C42B7C3

View file

@ -47,7 +47,9 @@ paths:
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/History" type: array
items:
"$ref": "#/components/schemas/History"
'401': '401':
"$ref": "#/components/responses/UnauthorizedError" "$ref": "#/components/responses/UnauthorizedError"
/me/history/{note}: /me/history/{note}:
@ -60,11 +62,11 @@ paths:
description: JSON Object which contains id, title, tags, last visit time and pinned status description: JSON Object which contains id, title, tags, last visit time and pinned status
responses: responses:
'200': '200':
description: The list of recently viewed notes and pinned notes. description: Information about the history entry
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/HistoryObject" "$ref": "#/components/schemas/History"
'401': '401':
"$ref": "#/components/responses/UnauthorizedError" "$ref": "#/components/responses/UnauthorizedError"
'404': '404':
@ -88,7 +90,7 @@ paths:
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/HistoryUpdateObject" "$ref": "#/components/schemas/HistoryUpdate"
responses: responses:
'200': '200':
description: The new history. description: The new history.
@ -853,7 +855,7 @@ components:
type: boolean type: boolean
disconnectSocketQueueLength: disconnectSocketQueueLength:
type: integer type: integer
HistoryObject: History:
type: object type: object
properties: properties:
metadata: metadata:
@ -861,20 +863,12 @@ components:
pinned: pinned:
type: boolean type: boolean
description: Whether the user has pinned this note. description: Whether the user has pinned this note.
HistoryUpdateObject: HistoryUpdate:
type: object type: object
properties: properties:
pinned: pinned:
type: boolean type: boolean
description: Whether the user has pinned this note. description: Whether the user has pinned this note.
History:
type: object
properties:
history:
type: array
description: The array that contains history objects.
items:
"$ref": "#/components/schemas/HistoryObject"
examples: examples:
markdownExample: markdownExample:
value: '# Some header\nSome normal text. **Some bold text**' value: '# Some header\nSome normal text. **Some bold text**'