add backend definition
This commit is contained in:
parent
b42a57d4df
commit
17ebcfd1cf
377
backend.yml
Normal file
377
backend.yml
Normal file
@ -0,0 +1,377 @@
|
|||||||
|
openapi: 3.0.3
|
||||||
|
info:
|
||||||
|
title: videON Backend
|
||||||
|
description: Backend of videON
|
||||||
|
contact:
|
||||||
|
email: tormakristof@tormakristof.eu
|
||||||
|
license:
|
||||||
|
name: Apache 2.0
|
||||||
|
url: http://www.apache.org/licenses/LICENSE-2.0.html
|
||||||
|
version: 1.0.0
|
||||||
|
servers:
|
||||||
|
- url: https://videon.k8s.kmlabz.com
|
||||||
|
tags:
|
||||||
|
- name: backend
|
||||||
|
description: videON Backend interaction
|
||||||
|
paths:
|
||||||
|
/api/users:
|
||||||
|
get:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Get all users
|
||||||
|
operationId: getall
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Array of users
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/UserMetadataResponse'
|
||||||
|
404:
|
||||||
|
description: No object matching filter
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/users/{username}:
|
||||||
|
get:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Get a user with a name
|
||||||
|
operationId: getauser
|
||||||
|
parameters:
|
||||||
|
- name: username
|
||||||
|
in: path
|
||||||
|
description: Username of a user
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: User's metadata
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/UserMetadata'
|
||||||
|
404:
|
||||||
|
description: No object matching filter
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
delete:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Delete a user
|
||||||
|
operationId: deleteuser
|
||||||
|
parameters:
|
||||||
|
- name: username
|
||||||
|
in: path
|
||||||
|
description: Username of a user
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: User's metadata
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/UserMetadata'
|
||||||
|
404:
|
||||||
|
description: No object matching filter
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/auth/signup:
|
||||||
|
put:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Creates a user
|
||||||
|
operationId: createuser
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/User'
|
||||||
|
required: true
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: successful operation
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
400:
|
||||||
|
description: JSON parse error
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
417:
|
||||||
|
description: JSON invalid schema
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/auth/login:
|
||||||
|
post:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Logs on a user
|
||||||
|
operationId: logon
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/User'
|
||||||
|
required: true
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: successful operation
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
400:
|
||||||
|
description: JSON parse error
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
417:
|
||||||
|
description: JSON invalid schema
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
/api/objects/streamerobject:
|
||||||
|
put:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Creates a streamer resource
|
||||||
|
operationId: createResource
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectSimpleData'
|
||||||
|
required: true
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Streamer resource data
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectData'
|
||||||
|
get:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Gets all streamer resource
|
||||||
|
operationId: getResource
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Streamer resource data
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectArray'
|
||||||
|
|
||||||
|
|
||||||
|
/api/objects/streamerobject/{id}:
|
||||||
|
delete:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Creates a streamer resource
|
||||||
|
operationId: deleteResource
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: path
|
||||||
|
description: ID of a resource
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Streamer resource data
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectData'
|
||||||
|
404:
|
||||||
|
description: ID not found
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
get:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Creates a streamer resource
|
||||||
|
operationId: getAResource
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: path
|
||||||
|
description: ID of a resource
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Streamer resource data
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectData'
|
||||||
|
404:
|
||||||
|
description: ID not found
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
post:
|
||||||
|
tags:
|
||||||
|
- backend
|
||||||
|
summary: Creates a streamer resource
|
||||||
|
operationId: editAResource
|
||||||
|
requestBody:
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/NeighbourseData'
|
||||||
|
required: true
|
||||||
|
parameters:
|
||||||
|
- name: id
|
||||||
|
in: path
|
||||||
|
description: ID of a resource
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
responses:
|
||||||
|
200:
|
||||||
|
description: Streamer resource data
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectData'
|
||||||
|
404:
|
||||||
|
description: ID not found
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ApiResponse'
|
||||||
|
|
||||||
|
components:
|
||||||
|
schemas:
|
||||||
|
StreamerObjectData:
|
||||||
|
required:
|
||||||
|
- type
|
||||||
|
- url
|
||||||
|
- id
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
type:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- ingest
|
||||||
|
- encoder
|
||||||
|
- restream
|
||||||
|
url:
|
||||||
|
type: string
|
||||||
|
format: url
|
||||||
|
id:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
inputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
outputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
StreamerObjectSimpleData:
|
||||||
|
required:
|
||||||
|
- type
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
type:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- ingest
|
||||||
|
- encoder
|
||||||
|
- restream
|
||||||
|
inputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
outputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
NeighbourseData:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
inputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
outputNeighbours:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
format: uuid
|
||||||
|
StreamerObjectArray:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/StreamerObjectData'
|
||||||
|
UserMetadataResponse:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/UserMetadata'
|
||||||
|
User:
|
||||||
|
required:
|
||||||
|
- name
|
||||||
|
- password
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
name:
|
||||||
|
type: string
|
||||||
|
password:
|
||||||
|
type: string
|
||||||
|
UserMetadata:
|
||||||
|
required:
|
||||||
|
- name
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
name:
|
||||||
|
type: string
|
||||||
|
creation_date:
|
||||||
|
type: string
|
||||||
|
format: date
|
||||||
|
last_logon:
|
||||||
|
type: string
|
||||||
|
format: date
|
||||||
|
ApiResponse:
|
||||||
|
required:
|
||||||
|
- message
|
||||||
|
- status
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
status:
|
||||||
|
type: string
|
||||||
|
message:
|
||||||
|
type: string
|
Loading…
Reference in New Issue
Block a user