99 lines
3.5 KiB
YAML
99 lines
3.5 KiB
YAML
/auth/login:
|
|
post:
|
|
operationId: loginUser
|
|
summary: Login to OpenVidu Meet
|
|
description: >
|
|
Authenticates a user and returns an access and refresh token in cookies.
|
|
tags:
|
|
- Internal API - Authentication
|
|
requestBody:
|
|
$ref: '../../components/requestBodies/internal/login-user.yaml'
|
|
responses:
|
|
'200':
|
|
$ref: '../../components/responses/internal/success-user-login.yaml'
|
|
'404':
|
|
$ref: '../../components/responses/internal/error-invalid-credentials.yaml'
|
|
'422':
|
|
$ref: '../../components/responses/validation-error.yaml'
|
|
'500':
|
|
$ref: '../../components/responses/internal-server-error.yaml'
|
|
/auth/logout:
|
|
post:
|
|
operationId: logoutUser
|
|
summary: Logout from OpenVidu Meet
|
|
description: >
|
|
Logs out the user and clears the access and refresh tokens from cookies.
|
|
tags:
|
|
- Internal API - Authentication
|
|
responses:
|
|
'200':
|
|
$ref: '../../components/responses/internal/success-user-logout.yaml'
|
|
/auth/refresh:
|
|
post:
|
|
operationId: refreshAccessToken
|
|
summary: Refresh access token
|
|
description: >
|
|
Refreshes the access token using the refresh token.
|
|
The new access token is returned in a cookie.
|
|
tags:
|
|
- Internal API - Authentication
|
|
security:
|
|
- refreshTokenHeader: []
|
|
responses:
|
|
'200':
|
|
$ref: '../../components/responses/internal/success-refresh-token.yaml'
|
|
'400':
|
|
$ref: '../../components/responses/internal/error-invalid-refresh-token.yaml'
|
|
'500':
|
|
$ref: '../../components/responses/internal-server-error.yaml'
|
|
|
|
/auth/api-keys:
|
|
post:
|
|
operationId: createApiKey
|
|
summary: Create a new API key
|
|
description: |
|
|
Creates a new API key, returning it in the response.
|
|
|
|
> **Note:** Only one API key can be created in the system.
|
|
> If an API key already exists, it will be replaced with the new one.
|
|
tags:
|
|
- Internal API - Authentication
|
|
security:
|
|
- accessTokenHeader: []
|
|
responses:
|
|
'201':
|
|
$ref: '../../components/responses/internal/success-create-api-key.yaml'
|
|
'500':
|
|
$ref: '../../components/responses/internal-server-error.yaml'
|
|
get:
|
|
operationId: getApiKeys
|
|
summary: Get API keys
|
|
description: |
|
|
Retrieves the existing API keys.
|
|
|
|
> **Note:** Only one API key can exist in the system.
|
|
> If no API key exists, an empty array will be returned.
|
|
tags:
|
|
- Internal API - Authentication
|
|
security:
|
|
- accessTokenHeader: []
|
|
responses:
|
|
'200':
|
|
$ref: '../../components/responses/internal/success-get-api-keys.yaml'
|
|
'500':
|
|
$ref: '../../components/responses/internal-server-error.yaml'
|
|
delete:
|
|
operationId: deleteApiKeys
|
|
summary: Delete API keys
|
|
description: >
|
|
Deletes the existing API keys.
|
|
tags:
|
|
- Internal API - Authentication
|
|
security:
|
|
- accessTokenHeader: []
|
|
responses:
|
|
'200':
|
|
$ref: '../../components/responses/internal/success-delete-api-key.yaml'
|
|
'500':
|
|
$ref: '../../components/responses/internal-server-error.yaml'
|