Overview
This document provides information on how to authenticate with the API for the application at Euler. The API supports token-based authentication, where the user submits their email and password to receive an access token, which will be used for subsequent requests.
Endpoint
URL
Method
POST
Request Format
The API expects the email and password of a user to be sent in the body of the request.
Request Headers
Header | Value |
Content-Type |
|
Request Body
The body should be formatted as JSON with the following fields:
Field | Type | Description |
| string | The email address of the user. |
| string | The user's password. |
Example Request Body
{
"email": "[email protected]",
"password": "userpassword"
}
Successful Response
If the email and password are correct, the API will return a JSON response containing the authentication token, user ID, and the token expiration time.
Response Format
{
"status": "success",
"response": {
"token": "bus|1234567890123x123456789012345678|2345678901234x98",
"user_id": "1234567890123x12",
"expires": 31536000
}
}
Fields
Field | Type | Description |
| string | Will be "success" if the request is successful. |
| string | The bearer token to be used for future requests. |
| string | The ID of the authenticated user. |
| int | The expiration time for the token, in seconds (in this case, one year). |
Example cURL Request
curl -X POST https://eulerapp.com/api/1.1/wf/generate-api-token \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"password": "userpassword"
}'
Error Response
If the credentials are invalid, the API will return a 400 error with a detailed message.
Example Error Response
{
"statusCode": 400,
"reason": "INVALID_LOGIN_CREDENTIALS",
"message": "We didn’t find an account with those login credentials",
"args":
{ "bubble_code": "2345678901234x987654321098765432"
}
}
Fields
Field | Type | Description |
| int | HTTP status code for the error. |
| string | The reason for the error. |
| string | A user-friendly message describing the error. |
| object | Additional information about the error (internal codes). |
Authentication for Subsequent Requests
After receiving the token, it should be included in the Authorization header for all subsequent requests as a Bearer token.
Example Request With Token
curl -X GET https://eulerapp.com/api/1.1/some-protected-endpoint \
-H "Authorization: Bearer bus|1234567890123x123456789012345678|2345678901234x98"