github/hedgedoc
1
0
Fork 0
mirror of https://github.com/hedgedoc/hedgedoc.git synced 2024-11-23 02:06:29 -05:00
Code Issues Projects Releases Packages Wiki Activity

descriptions always end with a dot

Browse source 
summaries never end with a dot

Signed-off-by: Philip Molares <philip.molares@udo.edu>
This commit is contained in:
Philip Molares 2020-06-06 23:26:48 +02:00 committed by David Mehren
parent 4c11b81dfb
commit 7dbadd2d0b
No known key found for this signature in database
GPG key ID: 6017AF117F9756CB
1 changed files with 123 additions and 123 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

246
docs/dev/openapi.yml
View file

@ -10,11 +10,11 @@ info:
name: AGPLv3 name: AGPLv3
url: https://github.com/codimd/server/blob/master/LICENSE url: https://github.com/codimd/server/blob/master/LICENSE
externalDocs: externalDocs:
description: CodiMD Documentation description: The CodiMD Documentation.
url: https://github.com/codimd/server/tree/master/docs url: https://github.com/codimd/server/tree/master/docs
servers: servers:
- url: "/api/v2/" - url: "/api/v2"
description: "Base API Path" description: The base API Path.
paths: paths:
/auth/email: /auth/email:
post: post:
@ -30,7 +30,7 @@ paths:
$ref: '#/components/schemas/EmailLogin' $ref: '#/components/schemas/EmailLogin'
responses: responses:
'200': '200':
description: login succesful description: The login was succesful.
headers: headers:
Set-Cookie: Set-Cookie:
schema: schema:
@ -49,7 +49,7 @@ paths:
$ref: '#/components/schemas/LdapLogin' $ref: '#/components/schemas/LdapLogin'
responses: responses:
'200': '200':
description: login succesful description: The login was succesful.
headers: headers:
Set-Cookie: Set-Cookie:
schema: schema:
@ -68,7 +68,7 @@ paths:
$ref: '#/components/schemas/OpenIdLogin' $ref: '#/components/schemas/OpenIdLogin'
responses: responses:
'200': '200':
description: login succesful description: The login was succesful.
headers: headers:
Set-Cookie: Set-Cookie:
schema: schema:
@ -81,13 +81,13 @@ paths:
operationId: getMe operationId: getMe
responses: responses:
'200': '200':
description: the user information description: The user information.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/UserInfo" "$ref": "#/components/schemas/UserInfo"
'401': '401':
description: the user is not logged in description: The user is not logged in.
content: {} content: {}
post: post:
tags: tags:
@ -96,10 +96,10 @@ paths:
operationId: updateMe operationId: updateMe
responses: responses:
'200': '200':
description: The user information was changed successfully description: The user information was changed successfully.
requestBody: requestBody:
required: true required: true
description: The new user information description: The new user information.
content: content:
application/json: application/json:
schema: schema:
@ -107,20 +107,20 @@ paths:
delete: delete:
tags: tags:
- user - user
summary: "Deletes the currently logged-in user from the backend and removes all it's notes" summary: Deletes the currently logged-in user from the backend and removes all their notes
operationId: deleteMe operationId: deleteMe
responses: responses:
'200': '200':
description: The user was deleted successfully description: The user was deleted successfully.
/me/export: /me/export:
get: get:
tags: tags:
- user - user
- export - export
summary: Exports a zip-archive with all notes of the currently logged-in user. summary: Exports a zip-archive with all notes of the currently logged-in user
responses: responses:
'200': '200':
description: The zip-archive with all notes description: The zip-archive with all notes.
/me/password: /me/password:
post: post:
tags: tags:
@ -128,24 +128,24 @@ paths:
summary: Sets the new password of currently logged-in user summary: Sets the new password of currently logged-in user
requestBody: requestBody:
required: true required: true
description: The new password of the user description: The new password of the user.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/UserPasswordChange" "$ref": "#/components/schemas/UserPasswordChange"
responses: responses:
'200': '200':
description: The password was changed description: The password was changed.
/me/history: /me/history:
get: get:
tags: tags:
- history - history
summary: Returns a list of the last viewed notes. summary: Returns a list of the last viewed notes
operationId: getHistory operationId: getHistory
description: The list is returned as a JSON object with an array containing for each entry it's id, title, tags, last visit time and pinned status. description: The list is returned as a JSON object with an array containing for each entry it's id, title, tags, last visit time and pinned status.
responses: responses:
'200': '200':
description: The list of recently viewed notes and pinned notes description: The list of recently viewed notes and pinned notes.
content: content:
application/json: application/json:
schema: schema:
@ -156,14 +156,14 @@ paths:
summary: Sets the history if none is already set summary: Sets the history if none is already set
operationId: updateHistory operationId: updateHistory
requestBody: requestBody:
description: The history to update description: The history to update.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/History" "$ref": "#/components/schemas/History"
responses: responses:
'200': '200':
description: The new history description: The new history.
content: content:
application/json: application/json:
schema: schema:
@ -175,7 +175,7 @@ paths:
operationId: deleteHistory operationId: deleteHistory
responses: responses:
'200': '200':
description: Deleted the history description: Deleted the history.
content: {} content: {}
/me/history/{note}: /me/history/{note}:
put: put:
@ -184,14 +184,14 @@ paths:
summary: Update the history object of the note (e.g change it's pin status) summary: Update the history object of the note (e.g change it's pin status)
operationId: updateHistoryObject operationId: updateHistoryObject
requestBody: requestBody:
description: The updated history object description: The updated history object.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/HistoryObject" "$ref": "#/components/schemas/HistoryObject"
responses: responses:
'200': '200':
description: The new history description: The new history.
content: content:
application/json: application/json:
schema: schema:
@ -200,7 +200,7 @@ paths:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the revision should be shown description: The note for which the revision should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -211,13 +211,13 @@ paths:
operationId: deleteHistoryObject operationId: deleteHistoryObject
responses: responses:
'200': '200':
description: The new history description: The new history.
content: {} content: {}
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the revision should be shown description: The note for which the revision should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -225,12 +225,12 @@ paths:
post: post:
tags: tags:
- note - note
summary: Imports some markdown data into a new note. summary: Imports some markdown data into a new note
operationId: createNoteFromMarkdown operationId: createNoteFromMarkdown
description: A random id will be assigned and the content will equal to the body of the received HTTP-request. description: A random id will be assigned and the content will equal to the body of the received HTTP-request.
requestBody: requestBody:
required: false required: false
description: The content of the note to be imported as markdown description: The content of the note to be imported as markdown.
content: content:
'text/markdown': 'text/markdown':
schema: schema:
@ -240,7 +240,7 @@ paths:
"$ref": '#/components/examples/markdownExample' "$ref": '#/components/examples/markdownExample'
responses: responses:
'200': '200':
description: Get information about the newly created note description: Get information about the newly created note.
content: content:
application/json: application/json:
schema: schema:
@ -249,35 +249,35 @@ paths:
get: get:
tags: tags:
- note - note
summary: Returns the note. summary: Returns the note
operationId: getNote operationId: getNote
description: This includes all metadata and the content of the note. description: This includes all metadata and the content of the note.
responses: responses:
'200': '200':
description: All data of the note description: All data of the note.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/Note" "$ref": "#/components/schemas/Note"
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the info should be shown description: The note for which the info should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
post: post:
tags: tags:
- note - note
summary: Imports some markdown data into a new note with a given alias. summary: Imports some markdown data into a new note with a given alias
operationId: createNoteWithAlias operationId: createNoteWithAlias
description: 'This endpoint equals to the above one except that the alias from the url will be assigned to the note if [FreeURL-mode](https://github.com/codimd/server/tree/master/docs/configuration-env-vars.md#users-and-privileges) is enabled.' description: This endpoint equals to the above one except that the alias from the url will be assigned to the note if [FreeURL-mode](https://github.com/codimd/server/tree/master/docs/configuration-env-vars.md#users-and-privileges) is enabled.
requestBody: requestBody:
required: true required: true
description: The content of the note to be imported as markdown description: The content of the note to be imported as markdown.
content: content:
'text/markdown': 'text/markdown':
schema: schema:
@ -287,18 +287,18 @@ paths:
"$ref": '#/components/examples/markdownExample' "$ref": '#/components/examples/markdownExample'
responses: responses:
'200': '200':
description: Get information about the newly created note description: Get information about the newly created note.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/Note" "$ref": "#/components/schemas/Note"
'409': '409':
description: This alias is already in use description: This alias is already in use.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the info should be shown description: The note for which the info should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -316,7 +316,7 @@ paths:
"$ref": "#/components/schemas/NotePermissions" "$ref": "#/components/schemas/NotePermissions"
responses: responses:
'200': '200':
description: The updated permissions of the note description: The updated permissions of the note.
content: content:
application/json: application/json:
schema: schema:
@ -325,7 +325,7 @@ paths:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the info should be shown description: The note for which the info should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -336,7 +336,7 @@ paths:
operationId: getNotePermissions operationId: getNotePermissions
responses: responses:
'200': '200':
description: The permissions of the note description: The permissions of the note.
content: content:
application/json: application/json:
schema: schema:
@ -345,7 +345,7 @@ paths:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the info should be shown description: The note for which the info should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -354,23 +354,23 @@ paths:
tags: tags:
- note - note
- export - export
summary: Returns the raw markdown content of a note. summary: Returns the raw markdown content of a note
operationId: getNoteContent operationId: getNoteContent
responses: responses:
'200': '200':
description: The raw markdown content of the note description: The raw markdown content of the note.
content: content:
'text/markdown': 'text/markdown':
schema: schema:
type: string type: string
format: binary format: binary
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the markdown should be exported description: The note for which the markdown should be exported.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -379,23 +379,23 @@ paths:
tags: tags:
- note - note
- export - export
summary: Returns the content of a note as HTML. summary: Returns the content of a note as HTML
operationId: getNoteContentAsHTML operationId: getNoteContentAsHTML
responses: responses:
'200': '200':
description: The raw html content of the note description: The raw html content of the note.
content: content:
'text/html': 'text/html':
schema: schema:
type: string type: string
format: binary format: binary
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the html should be exported description: The note for which the html should be exported.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -404,22 +404,22 @@ paths:
tags: tags:
- note - note
- export - export
summary: Exports the content of a note to a gist. summary: Exports the content of a note to a gist
operationId: exportNoteToGist operationId: exportNoteToGist
responses: responses:
'200': '200':
description: The link to Gist of the note description: The link to Gist of the note.
content: content:
application/json: application/json:
schema: schema:
"$ref": '#/components/schemas/GistLink' "$ref": '#/components/schemas/GistLink'
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note which should be exported to gist description: The note which should be exported to gist.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -428,22 +428,22 @@ paths:
tags: tags:
- note - note
- export - export
summary: Exports the content of a note to dropbox. summary: Exports the content of a note to dropbox
operationId: exportNoteToDropbox operationId: exportNoteToDropbox
responses: responses:
'200': '200':
description: The dropbox link of the note description: The dropbox link of the note.
content: content:
application/json: application/json:
schema: schema:
"$ref": '#/components/schemas/DropboxLink' "$ref": '#/components/schemas/DropboxLink'
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note which should be exported to dropbox description: The note which should be exported to dropbox.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -452,23 +452,23 @@ paths:
tags: tags:
- note - note
- export - export
summary: Exports the content of a note as PDF. summary: Exports the content of a note as PDF
operationId: exportNoteToPDF operationId: exportNoteToPDF
responses: responses:
'200': '200':
description: The note as an PDF description: The note as an PDF.
content: content:
application/pdf: application/pdf:
schema: schema:
type: string type: string
format: binary format: binary
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note which should be exported to dropbox description: The note which should be exported to dropbox.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -476,23 +476,23 @@ paths:
get: get:
tags: tags:
- note - note
summary: Returns a list of the available note revisions. summary: Returns a list of the available note revisions
operationId: getAllRevisionsOfNote operationId: getAllRevisionsOfNote
description: The list is returned as a JSON object with an array of revision-id and length associations. The revision-id equals to the timestamp when the revision was saved. description: The list is returned as a JSON object with an array of revision-id and length associations. The revision-id equals to the timestamp when the revision was saved.
responses: responses:
'200': '200':
description: Revisions of the note description: Revisions of the note.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/NoteRevisionsMetadata" "$ref": "#/components/schemas/NoteRevisionsMetadata"
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which revisions should be shown description: The note for which revisions should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
@ -501,30 +501,30 @@ paths:
get: get:
tags: tags:
- note - note
summary: Returns the revision of the note with some metadata. summary: Returns the revision of the note with some metadata
operationId: getSpecificRevisionOfNote operationId: getSpecificRevisionOfNote
description: The revision is returned as a JSON object with the content of the note and the authorship. description: The revision is returned as a JSON object with the content of the note and the authorship.
responses: responses:
'200': '200':
description: Revision of the note for the given timestamp description: Revision of the note for the given timestamp.
content: content:
application/json: application/json:
schema: schema:
"$ref": "#/components/schemas/NoteRevision" "$ref": "#/components/schemas/NoteRevision"
'404': '404':
description: Note does not exist description: Note does not exist.
parameters: parameters:
- name: note - name: note
in: path in: path
required: true required: true
description: The note for which the revision should be shown description: The note for which the revision should be shown.
content: content:
text/plain: text/plain:
example: my-note example: my-note
- name: revision-id - name: revision-id
in: path in: path
required: true required: true
description: The id (timestamp) of the revision to fetch description: The id (timestamp) of the revision to fetch.
content: content:
text/plain: text/plain:
example: 1570921051959 example: 1570921051959
@ -536,7 +536,7 @@ paths:
operationId: getConfig operationId: getConfig
responses: responses:
'200': '200':
description: The config description: The config of the backend in JSON.
content: content:
application/json: application/json:
schema: schema:
@ -545,12 +545,12 @@ paths:
get: get:
tags: tags:
- server - server
summary: Returns the current status of the backend. summary: Returns the current status of the backend
operationId: getStatus operationId: getStatus
description: The data is returned as a JSON object containing the number of notes stored on the server, (distinct) online users and more. description: The data is returned as a JSON object containing the number of notes stored on the server, (distinct) online users and more.
responses: responses:
'200': '200':
description: The server info description: The server info.
content: content:
application/json: application/json:
schema: schema:
@ -581,63 +581,63 @@ components:
properties: properties:
name: name:
type: string type: string
description: The new display name of the user description: The new display name of the user.
Config: Config:
type: object type: object
properties: properties:
allowAnonymous: allowAnonymous:
type: boolean type: boolean
description: Wether anonymous notes are allowed description: Wether anonymous notes are allowed.
authProviders: authProviders:
type: object type: object
properties: properties:
facebook: facebook:
type: boolean type: boolean
description: Wether Facebook login is possible description: Wether Facebook login is possible.
github: github:
type: boolean type: boolean
description: Wether GitHub login is possible description: Wether GitHub login is possible.
twitter: twitter:
type: boolean type: boolean
description: Wether Twitter login is possible description: Wether Twitter login is possible.
gitlab: gitlab:
type: boolean type: boolean
description: Wether Gitlab login is possible description: Wether Gitlab login is possible.
dropbox: dropbox:
type: boolean type: boolean
description: Wether Dropbox login is possible description: Wether Dropbox login is possible.
google: google:
type: boolean type: boolean
description: Wether Google login is possible description: Wether Google login is possible.
saml: saml:
type: boolean type: boolean
description: Wether SAML login is possible description: Wether SAML login is possible.
oauth2: oauth2:
type: boolean type: boolean
description: Wether OAuth2 login is possible description: Wether OAuth2 login is possible.
email: email:
type: boolean type: boolean
description: Wether E-Mail login is possible description: Wether E-Mail login is possible.
ldap: ldap:
type: boolean type: boolean
description: Wether LDAP login is possible description: Wether LDAP login is possible.
openid: openid:
type: boolean type: boolean
description: Wether OpenID login is possible description: Wether OpenID login is possible.
customAuthNames: customAuthNames:
type: object type: object
properties: properties:
ldap: ldap:
type: string type: string
description: The custom name for the LDAP Login description: The custom name for the LDAP Login.
example: "FooBar LDAP" example: "FooBar LDAP"
oauth2: oauth2:
type: string type: string
description: The custom name for the OAuth2 Login description: The custom name for the OAuth2 Login.
example: "Olaf2" example: "Olaf2"
saml: saml:
type: string type: string
description: The custom name for the SAML Login description: The custom name for the SAML Login.
example: "aufSAMLn.de" example: "aufSAMLn.de"
specialLinks: specialLinks:
type: object type: object
@ -645,15 +645,15 @@ components:
privacy: privacy:
type: string type: string
format: uri format: uri
description: Link to the privacy notice description: Link to the privacy notice.
termsOfUse: termsOfUse:
type: string type: string
format: uri format: uri
description: Link to the terms of use description: Link to the terms of use.
imprint: imprint:
type: string type: string
format: uri format: uri
description: Link to the imprint description: Link to the imprint.
version: version:
type: object type: object
properties: properties:
@ -671,39 +671,39 @@ components:
id: id:
type: string type: string
format: UUIDv4 format: UUIDv4
description: The id of the note description: The id of the note.
alias: alias:
type: string type: string
description: The alias of the note description: The alias of the note.
lastChange: lastChange:
type: object type: object
properties: properties:
userId: userId:
type: string type: string
format: UUIDv4 format: UUIDv4
description: The id of the user that last changed the note description: The id of the user that last changed the note.
user: user:
type: string type: string
description: The name of the user that last changed the note description: The name of the user that last changed the note.
timestamp: timestamp:
type: integer type: integer
description: UNIX-timestamp of when the note was last changed. description: UNIX-timestamp of when the note was last changed.
viewcount: viewcount:
type: integer type: integer
minimum: 0 minimum: 0
description: How often the published version of the note was viewed description: How often the published version of the note was viewed.
createtime: createtime:
type: string type: string
description: The timestamp when the note was created in ISO 8601 format. description: The timestamp when the note was created in ISO 8601 format.
content: content:
type: string type: string
description: The raw markdown content of the note revision description: The raw markdown content of the note revision.
authorship: authorship:
type: array type: array
description: Data which gives insights about who worked on the note description: Data which gives insights about who worked on the note.
items: items:
type: integer type: integer
description: Unique user ids and additional data description: Unique user ids and additional data.
NotePermissions: NotePermissions:
type: object type: object
properties: properties:
@ -715,7 +715,7 @@ components:
properties: properties:
revision: revision:
type: array type: array
description: Array that holds all revision-info objects description: Array that holds all revision-info objects.
items: items:
type: object type: object
properties: properties:
@ -724,22 +724,22 @@ components:
description: UNIX-timestamp of when the revision was saved. Is also the revision-id. description: UNIX-timestamp of when the revision was saved. Is also the revision-id.
length: length:
type: integer type: integer
description: Length of the document to the timepoint the revision was saved description: Length of the document to the timepoint the revision was saved.
NoteRevision: NoteRevision:
type: object type: object
properties: properties:
content: content:
type: string type: string
description: The raw markdown content of the note revision description: The raw markdown content of the note revision.
authorship: authorship:
type: array type: array
description: Data which gives insights about who worked on the note description: Data which gives insights about who worked on the note.
items: items:
type: integer type: integer
description: Unique user ids and additional data description: Unique user ids and additional data.
patch: patch:
type: array type: array
description: Data which gives insight about what changed in comparison to former revisions description: Data which gives insight about what changed in comparison to former revisions.
items: items:
type: string type: string
GistLink: GistLink:
@ -748,14 +748,14 @@ components:
link: link:
type: string type: string
format: uri format: uri
description: A Gist link description: A Gist link.
DropboxLink: DropboxLink:
type: object type: object
properties: properties:
link: link:
type: string type: string
format: uri format: uri
description: A Dropbox link description: A Dropbox link.
EmailLogin: EmailLogin:
type: object type: object
properties: properties:
@ -784,25 +784,25 @@ components:
properties: properties:
onlineNotes: onlineNotes:
type: integer type: integer
description: How many notes are edited at the moment description: How many notes are edited at the moment.
onlineUsers: onlineUsers:
type: integer type: integer
description: How many users are online at the moment description: How many users are online at the moment.
distinctOnlineUsers: distinctOnlineUsers:
type: integer type: integer
description: How many distinct users (different machines) are online at the moment description: How many distinct users (different machines) are online at the moment.
notesCount: notesCount:
type: integer type: integer
description: How many notes are stored on the server description: How many notes are stored on the server.
registeredUsers: registeredUsers:
type: integer type: integer
description: How many users are registered on the server description: How many users are registered on the server.
onlineRegisteredUsers: onlineRegisteredUsers:
type: integer type: integer
description: How many of the online users are registered on the server description: How many of the online users are registered on the server.
distinctOnlineRegisteredUsers: distinctOnlineRegisteredUsers:
type: integer type: integer
description: How many of the distinct online users are registered on the server description: How many of the distinct online users are registered on the server.
isConnectionBusy: isConnectionBusy:
type: boolean type: boolean
connectionSocketQueueLength: connectionSocketQueueLength:
@ -816,27 +816,27 @@ components:
properties: properties:
id: id:
type: string type: string
description: The id or alias of the note description: The id or alias of the note.
title: title:
type: string type: string
description: The title of the note description: The title of the note.
lastVisited: lastVisited:
type: integer type: integer
description: The UNIX-timestamp in milliseconds when the note was last accessed by the user description: The UNIX-timestamp in milliseconds when the note was last accessed by the user.
tags: tags:
type: array type: array
description: The tags that were added by the user to the note description: The tags that were added by the user to the note.
items: items:
type: string type: string
pinned: pinned:
type: boolean type: boolean
description: Whether the user has pinned this note description: Whether the user has pinned this note.
History: History:
type: object type: object
properties: properties:
history: history:
type: array type: array
description: The array that contains history objects description: The array that contains history objects.
items: items:
"$ref": "#/components/schemas/HistoryObject" "$ref": "#/components/schemas/HistoryObject"
examples: examples: