184 lines
4.4 KiB
YAML
184 lines
4.4 KiB
YAML
basePath: /v1
|
|
info:
|
|
contact: {}
|
|
title: Go-Gin Prepack
|
|
version: "1"
|
|
paths:
|
|
/adm/doot:
|
|
get:
|
|
description: admin ping and login check
|
|
parameters:
|
|
- description: JWT Cookie set by /admin
|
|
in: header
|
|
name: jwt
|
|
required: true
|
|
type: string
|
|
responses: {}
|
|
summary: ping example
|
|
/admin:
|
|
post:
|
|
consumes:
|
|
- application/json
|
|
description: Secured login for any user accounts
|
|
parameters:
|
|
- description: user email
|
|
in: body
|
|
name: userkey
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: user password
|
|
in: body
|
|
name: password
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: the 2fa token
|
|
in: body
|
|
name: twofactorcode
|
|
required: true
|
|
schema:
|
|
type: string
|
|
produces:
|
|
- application/json
|
|
responses:
|
|
"200":
|
|
description: ""
|
|
headers:
|
|
jwt:
|
|
description: The authentication token for this session, valid for 24h
|
|
type: string
|
|
"400":
|
|
description: userkey, 2fa token or password missing
|
|
"401":
|
|
description: not found or credentials invalid
|
|
summary: User login
|
|
/doot:
|
|
get:
|
|
description: unauthenticated ping
|
|
responses: {}
|
|
summary: ping example
|
|
/forgot:
|
|
post:
|
|
consumes:
|
|
- application/json
|
|
description: Request a password reset for the provided userkey
|
|
parameters:
|
|
- description: user email to reset
|
|
in: body
|
|
name: userkey
|
|
required: true
|
|
schema:
|
|
type: string
|
|
produces:
|
|
- application/json
|
|
responses:
|
|
"200":
|
|
description: ""
|
|
"400":
|
|
description: userkey not provided
|
|
summary: Forgot password
|
|
/login:
|
|
post:
|
|
consumes:
|
|
- application/json
|
|
description: Secured login for any user accounts
|
|
parameters:
|
|
- description: user email
|
|
in: body
|
|
name: userkey
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: user password
|
|
in: body
|
|
name: password
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: the 2fa token for the user, if activated
|
|
in: body
|
|
name: twofactorcode
|
|
schema:
|
|
type: string
|
|
produces:
|
|
- application/json
|
|
responses:
|
|
"200":
|
|
description: ""
|
|
headers:
|
|
jwt:
|
|
description: The authentication token for this session, valid for 24h
|
|
type: string
|
|
"400":
|
|
description: userkey or password missing
|
|
"401":
|
|
description: not found or credentials invalid
|
|
summary: User login
|
|
/reset:
|
|
post:
|
|
consumes:
|
|
- application/json
|
|
description: Use a JWT token to validate and reset a password
|
|
parameters:
|
|
- description: the token emailed to the user
|
|
in: body
|
|
name: token
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: the new password value
|
|
in: body
|
|
name: password
|
|
required: true
|
|
schema:
|
|
type: string
|
|
produces:
|
|
- application/json
|
|
responses:
|
|
"200":
|
|
description: ""
|
|
"400":
|
|
description: token and password not provided
|
|
"401":
|
|
description: bad token or user not found
|
|
summary: Password reset
|
|
/sec/doot:
|
|
get:
|
|
description: user ping and login check
|
|
parameters:
|
|
- description: JWT Cookie set by /login
|
|
in: header
|
|
name: jwt
|
|
required: true
|
|
type: string
|
|
responses: {}
|
|
summary: ping example
|
|
/signup:
|
|
post:
|
|
consumes:
|
|
- application/json
|
|
description: Sign a user up for a new account
|
|
parameters:
|
|
- description: user email
|
|
in: body
|
|
name: userkey
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- description: user password
|
|
in: body
|
|
name: password
|
|
required: true
|
|
schema:
|
|
type: string
|
|
produces:
|
|
- application/json
|
|
responses:
|
|
"200":
|
|
description: ""
|
|
"400":
|
|
description: userkey missing, or password missing or not strong enough
|
|
summary: User signup
|
|
swagger: "2.0"
|