Authentication

API endpoints specifications

auth

Login and retrieve an authentication token

post

Login and retrieve an authentication token Authentication: not required

Body

application/jsonmultipart/form-data

emailstring · emailOptional

passwordstringOptional

Responses

200

Success!

application/json

400

Input Error. Check the request payload for issues.

401

Unauthorized

403

Access denied. Additional privileges are needed access the requested resource.

404

Not Found. The requested resource does not exist.

429

Rate Limited. Too many requests.

500

Unexpected error

post

HTTPcURLJavaScriptPython

POST /api:auth/auth/login HTTP/1.1
Host: api.answr.space
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "email": "[e-mail]",
  "password": "text"
}

application/jsonmultipart/form-data

{
  "authToken": "text",
  "user": "text"
}

Get the user record belonging to the authentication token

get

Get the user record belonging to the authentication token Authentication: required

Authorizations

Responses

200

Success!

application/json

400

Input Error. Check the request payload for issues.

401

Unauthorized

403

Access denied. Additional privileges are needed access the requested resource.

404

Not Found. The requested resource does not exist.

429

Rate Limited. Too many requests.

500

Unexpected error

get

HTTPcURLJavaScriptPython

GET /api:auth/auth/me HTTP/1.1
Host: api.answr.space
Authorization: Bearer JWT
Accept: */*

{
  "id": 1,
  "created_at": "now",
  "name": "text",
  "email": "[e-mail]",
  "role": "admin",
  "company": "text",
  "active_requests": 1
}

Signup and retrieve an authentication token

post

Signup and retrieve an authentication token Authentication: not required

Body

application/jsonmultipart/form-data

namestringRequired

emailstring · emailRequired

passwordstringRequired

companystringRequired

Responses

200

Success!

application/json

400

Input Error. Check the request payload for issues.

401

Unauthorized

403

Access denied. Additional privileges are needed access the requested resource.

404

Not Found. The requested resource does not exist.

429

Rate Limited. Too many requests.

500

Unexpected error

post

HTTPcURLJavaScriptPython

POST /api:auth/auth/signup HTTP/1.1
Host: api.answr.space
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "name": "text",
  "email": "[e-mail]",
  "password": "text",
  "company": "text"
}

application/jsonmultipart/form-data

{
  "authToken": "text",
  "user": "text"
}