kiolyn-api-specs
Version:
32 lines (31 loc) • 879 B
YAML
/authenticate:
post:
tags:
- user
description: Authenticate a user by username and password
operationId: authenticate
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticateRequest'
responses:
200:
description: successfylly authenticate a user
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticateResponse'
400:
description: missing either username or password
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
401:
description: could not authenticate user
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'