forks/peertube
1
0
Fork 0
Code Releases Activity

Apidoc (#302)

Browse source 
* 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
This commit is contained in:
Dimitri Gilbert 2018-02-17 19:24:56 +01:00 committed by Chocobozzz
parent 702785a54c
commit 44cb3b85f8
1 changed files with 195 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

195
support/doc/api/openapi.yaml
View file

@ -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