Authentification

Authentification routes.

Authenticate a user

Authenticate a user with a password or token.

Request
Request Body schema: application/json

A JSON object containing authentication information.

One of:
user
required
string

The mail or login of the user.

password
required
string

The password for the user.

hub
boolean

The hub flag for the user.

remember
boolean

The remember flag for the user.

Responses
200

Successful operation

401

Unauthorized

422

Unprocessable Entity

post/auth
Request samples
application/json
{
  • "user": "titan@nordantech.com",
  • "password": "WoWar1chUnsicher?"
}
Response samples
application/json
{
  • "success": true,
  • "hash": "fe1a21dc09531b90a716b24338cc0d41f2160ebe",
  • "data": {
    },
  • "timestamp": 1653472490807
}

Authenticate a user with code

Authenticate the current user using a login code.

SecurityJWT
Responses
200

Successful operation

401

Unauthorized

post/auth/code
Request samples
curl -i -X POST \
  https://api.nordan.tech/v1/auth/code \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Invalidate the hub

Invalidate the hub for a user session.

SecurityJWT
Responses
200

Successful operation

401

Unauthorized

post/auth/hub/invalidate
Request samples
curl -i -X POST \
  https://api.nordan.tech/v1/auth/hub/invalidate \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Change the hub

Change the hub for a user.

SecurityJWT
Request
path Parameters
hub
required
string

The id/hash of the current hub.

Responses
200

Successful operation

401

Unauthorized

post/auth/hub/{hub}
Request samples
curl -i -X POST \
  'https://api.nordan.tech/v1/auth/hub/{hub}' \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Complete the hub signup

Complete the hub signup.

Request
path Parameters
hubsignup
required
string

The id/hash of the current hub signup.

query Parameters
signature
required
string

The signature for the current hub signup.

Responses
200

Successful operation

401

Unauthorized

403

Forbidden

post/auth/hubsignup/{hubsignup}
Request samples
curl -i -X POST \
  'https://api.nordan.tech/v1/auth/hubsignup/{hubsignup}?signature=string'
Response samples
application/json
{
  • "value": {
    }
}

Invalidate the user

Invalidate the user session.

SecurityJWT
Responses
200

Successful operation

401

Unauthorized

post/auth/invalidate
Request samples
curl -i -X POST \
  https://api.nordan.tech/v1/auth/invalidate \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Reset the user password

Reset the user password.

SecurityJWT
Request
Request Body schema: application/json

A JSON object containing authentication information.

user
required
string

The mail or login of the user.

Responses
200

Successful operation

401

Unauthorized

422

Unprocessable Entity

post/auth/password/reset
Request samples
application/json
{
  • "value": {
    }
}
Response samples
application/json
{
  • "value": {
    }
}

Ping

Refresh the current token silently.

SecurityJWT
Responses
200

Successful operation

401

Unauthorized

post/auth/ping
Request samples
curl -i -X POST \
  https://api.nordan.tech/v1/auth/ping \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Refresh

Refresh the current token.

SecurityJWT
Responses
200

Successful operation

401

Unauthorized

post/auth/refresh
Request samples
curl -i -X POST \
  https://api.nordan.tech/v1/auth/refresh \
  -H 'Authorization: Bearer <YOUR_Bearer <TOKEN>_HERE>'
Response samples
application/json
{
  • "value": {
    }
}

Confirm email change

Authenticate the given user email verification.

Request
path Parameters
useremailverification
required
string

The id/hash of the user email verification.

query Parameters
signature
required
string

The signature for the current ueser email verification.

Responses
200

Successful operation

401

Unauthorized

403

Forbidden

post/auth/useremailverification/{useremailverification}
Request samples
curl -i -X POST \
  'https://api.nordan.tech/v1/auth/useremailverification/{useremailverification}?signature=string'
Response samples
application/json
{
  • "value": {
    }
}

Authenticate user invite

Authenticate the given user invite.

Request
path Parameters
userinvite
required
string

The id/hash of the user invite.

query Parameters
signature
required
string

The signature for the current user invite.

Responses
200

Successful operation

401

Unauthorized

403

Forbidden

post/auth/userinvite/{userinvite}
Request samples
curl -i -X POST \
  'https://api.nordan.tech/v1/auth/userinvite/{userinvite}?signature=string'
Response samples
application/json
{
  • "value": {
    }
}