Authenticate User
POST/authenticate
Authenticates a user account using login details and returns a temporary `x-access-token` header (valid for 6 hours) that can be used with this API.
Only users that have been given API access are able to authenticate successfully. If you create a new user account and wish to use it, let us know so we can enable it.
Request
Header Parameters
An integration test header to skip normal execution and force a particular HTTP status response (ie 200
, 400
, 404
, 500
). Can be used in ALL entry points even if not explicitly mentioned.
- application/json
Body
required
Authentication info
The email for this user
The password for this user
Responses
- 200
- 400
- 401
- 403
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
A unique identifier for this user.
A token for loging in to the API using the x-access-token
header. Expires after 6 hours.
If the user has a valid payment method
{
"user_uid": "29a7ca912f49",
"x-access-token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOiIyOWE3Y2E5MTJmNDkiLCJyb2xlIjoiIiwiaWF0IjoxNjA2MTMwMDY2LCJleHAiOjE2MDYxNzAwNjZ9.QHK3e9QlvJT0izNQoxJzBLv6SAEYX-Ms6BIl_bMCj0U",
"has_payment_method": true
}
Bad request (ie. Missing email/password)
Unauthorized (ie. Incorrect password)
Forbidden (ie. User does not have API access)
Internal server Error (ie. Database down)