api/docs/account/register.md

1.7 KiB

/account/register - POST

Requests a new nerdcult account. This sends a verification E-Mail which contains a link to the veriication frontend with an verification token as url parameter. This verification link will time out after 10 minutes.

HTTP Headers

Header Content
Content-Type application/json

Content - JSON

Field Description
username The accounts username / userid.
password The password used for authentication.
email The email address used for validation.

The password has to meet the following criteria:

  • minimum length: 12 characters
  • numbers
  • special characters
  • lowercase letters
  • uppercase letters

Responses

200 - Success

The verification request was sent.

400 - Error: Bad Request

The request was malformed.

403 - Error: Forbidden

Blocked for security reasons.

409 - Error: Conflict

The requested username or email is already taken.

Content - JSON:

Field Description
conflict Can be username or email, depending on what caused the conflict.

422 - Error: Unprocessable Entity

The email is malformed, or the password does not meet the criteria.

Content - JSON:

Field Description
problem Can be email or password, depending on what caused the problem.