Create token

Create Access Token

The "Create Access Token" endpoint allows a user to generate new access and refresh tokens by providing their email and password. These tokens are essential for authenticating and authorizing API requests.

Authentication

• Include your x-api-key The API key provided by GenLogs. This header must be included in the request.

Endpoint

• URL: https://api.genlogs.io/auth/token

• Method: POST

Request Parameters

• email (string, required): The email address of the user requesting the tokens.

• password (string, required): The password of the user for authentication. It must be URL-encoded to ensure correct transmission. Certain characters, such as "+", can cause errors if not encoded. For example, "1234+" should be encoded as "1234%2B".

  • Here's a link to a URL encoder tool that you can use: URL-encoder

Response

• 200 OK: Successfully generated and returned the access and refresh tokens.

• 401 Unauthorized: If the provided email, and password, resulting in a failure to create the tokens.

• 500 Internal Server Error: If an error occurs on the server during token creation.

Response Body

• access_token_data (TokenSchema): The schema representing the access token and its expiration.

  • token (string): The access token string used for authentication or authorization.

  • expires (datetime): The datetime when the access token will expire.

• refresh_token_data (TokenSchema): The schema representing the refresh token and its expiration.

  • token (string): The refresh token string used for obtaining a new access token.

  • expires (datetime): The datetime when the refresh token will expire.

• user_id (string): The ID of the user for whom the tokens were created.

Request Example:

curl -X POST 'https://api.genlogs.io/auth/token/?email={email}&password={password}' \
-H 'accept: application/json' \
-H 'x-api-key: {your_api_key}'

Create Access Token

Create and return new access and refresh tokens for a user based on their email and password.

Args: email (str): The email of the user for whom the tokens are created. password (str): The password of the user for authentication.

Returns: AuthSchema: The schema containing the new access and refresh tokens.

Raises: HTTPException: If the token creation fails due to incorrect credentials.

POSThttps://api.genlogs.io/auth/token

Query parameters

Header parameters

Response

200422

Successful Response

Body

application/json

access_token_data*TokenSchema

Schema representing a token and its expiration.

This schema defines the structure of a token which includes the token string itself and its expiration datetime.

Attributes: token (str): The token string used for authentication or authorization purposes. expires (datetime): The datetime when the token will expire.

refresh_token_data*TokenSchema

Schema representing a token and its expiration.

This schema defines the structure of a token which includes the token string itself and its expiration datetime.

Attributes: token (str): The token string used for authentication or authorization purposes. expires (datetime): The datetime when the token will expire.

user_id*User Id

Request

JavaScriptCurlPython

const response = await fetch('https://api.genlogs.io/auth/token?email=text&password=text', {
    method: 'POST',
    headers: {
      "accept": "application/json",
      "x-api-key": "[x-api-key]"
    },
});
const data = await response.json();

Response

200422

{
  "access_token_data": {
    "token": "text",
    "expires": "2024-11-21T10:08:03.650Z"
  },
  "refresh_token_data": {
    "token": "text",
    "expires": "2024-11-21T10:08:03.650Z"
  }
}