From: Dimitri Gilbert Date: Sat, 17 Feb 2018 18:24:56 +0000 (+0100) Subject: Apidoc (#302) X-Git-Tag: v0.0.26-alpha~25 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=44cb3b85f8299b6300a23fea9e04b7f6e20a8023;p=oweals%2Fpeertube.git Apidoc (#302) * Basic api documentation * fix styling issue * fix styling issue * gitignore unecessary folders * openApi 2.0 first draft * solved conflicts * solved errors in openapi file * added missing doc on video + deleted apidoc comments * fix last warnings and errors inopenapi definition * openapi fix typo + improvement on video/comment endpoints * removed misplaced openapi file * api documentation improvement --- diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yaml index f00e40737..bcb0c511e 100644 --- a/support/doc/api/openapi.yaml +++ b/support/doc/api/openapi.yaml @@ -18,6 +18,21 @@ paths: required: true type: string description: 'The id of the account' + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -59,6 +74,27 @@ paths: - application/json produces: - application/json + parameters: + - name: state + in: path + required: true + type: string + description: 'The id of the account' + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: count + in: query + required: false + type: number + description: '' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -91,6 +127,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -106,6 +158,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -154,6 +222,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -289,6 +373,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -339,6 +439,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -414,6 +530,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -536,6 +668,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -601,6 +749,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -616,6 +780,22 @@ paths: - application/json produces: - application/json + parameters: + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation @@ -728,6 +908,21 @@ paths: required: true type: string description: 'The video id ' + - name: start + in: query + required: false + type: number + description: 'starting page' + - name: stop + in: query + required: false + type: number + description: 'stoping page' + - name: sort + in: query + required: false + type: number + description: 'sorting' responses: '200': description: successful operation