From 44cb3b85f8299b6300a23fea9e04b7f6e20a8023 Mon Sep 17 00:00:00 2001 From: Dimitri Gilbert Date: Sat, 17 Feb 2018 19:24:56 +0100 Subject: 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 --- support/doc/api/openapi.yaml | 195 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 195 insertions(+) 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 -- cgit v1.2.3