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

authTokenstringOptional

userstringOptional

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/auth/login

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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Success!

application/json

idinteger · int64Optional

created_atnumber · timestamptzOptionalDefault: now

namestringOptional

emailstring · email · nullableOptional

rolestring · enumOptionalPossible values:

companystringOptional

active_requestsinteger · int64Optional

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/auth/me

HTTPcURLJavaScriptPython

GET /api:auth/auth/me HTTP/1.1
Host: api.answr.space
Authorization: Bearer YOUR_SECRET_TOKEN
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

authTokenstringOptional

userstringOptional

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/auth/signup

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"
}