Autenticación

Todas las peticiones realizadas a la API deberán ir con su header de autenticación, a continuación se muestra un ejemplo de como realizarlo.

Obtener token de acceso

POST https://{clave}.admintotal.com/api/v2/usuarios/login_usuario/

Este endpoint se encarga de autenticar a los usuarios y retornar el api key que debe ser utilizado en todas las peticiones a la api.

Ya que obtenemos el api_key debemos de enviar ese valor en TODAS las peticiones el header Api-key de la siguiente forma: "Api-key: {api_key}"

Request Body

Name	Type	Description
username	string	Nombre de usuario a autenticar
password	string	Contraseña del usuario

200

{
    "ok": true,
    "usuario": {
        "id": 104,
        "api_key": "...",
        "username": "johndoe",
        "nombre": "John Doe",
        ...
    }
}

Autenticación basada en JWT (Recomendado)

Al utilizar este método de autenticación, TODAS las peticiones realizadas a la API deberán incluir el header Authorization de la siguiente forma: "Authorization: Bearer {access_token}"

Obtener token JWT

POST https://{clave}.admintotal.com/api/v2/token/

Endpoint para obtener access token y refresh token

Request Body

Name	Type	Description
username	string	Nombre de usuario a autenticar
password	string	Contraseña del usuario

200

{
    "refresh": "eyJ0XAiO...",
    "access": "eyJ0eXAiO..."
}

Refrescar token JWT

POST https://{clave}.admintotal.com/api/v2/refresh/

Endpoint para obtener un nuevo access token una vez que éste expira.

Request Body

Name	Type	Description
refresh	string	Refresh token

200

{
    "access": "eyJ0eX..."
}