Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can access the token via authentication in API using username and password. (edited)  

Documentation

  • Endpoint: POST /api/v2/users/sign_in

  • Authentication: Not required

  • Request Body Format: x-www-form-urlencoded

  • Body

    • user[email] (string, required): The email address of the user.

    • user[password] (string, required): The password associated with the user's account.

  • Response Format: JSON

  • Response Attributes

    • user_id (integer): The unique identifier for the user.

    • email (string): The email address of the authenticated user.

    • authentication_token (string): The long-lived authentication token used for subsequent authenticated requests.

Example response

Code Block
{
    "user_id": 1,
    "email": "user@example.com",
    "authentication_token": "<long token>"
}

...

Using API with curl

cURL Request to authenticate:

curl -X POST -d user[email]="user@example.com" -d user[password]="pwd" https://staging.makerble.com/api/v2/users/sign_in
Response:
{"user_id": 1, "email": "user@example.com", "authentication_token": "<long token>"}

cURL request to access api
curl --header "X-User-Token: <long token>" --header "X-User-Email: user@example.com" https://staging.makerble.com/api/v2/beneficiary_categories

...

Related information

...

  • If you want activity to be recorded about multiple users (as though they were individual users on the web platform) you should build API interactions with every user rather than only having API interactions go via an Organisation Admin user.

  • However if the integration that you are building does not require that actions be attributed to specific users, you could instead only build API interactions with a single Organisation Admin user

  • There is no expiry of each authentication token. Each user has a fixed token.