Saltar al contenido principal

Autenticación​

Para cualquier operación con la API es necesario autenticarse y obtener un token válido. Existen dos formas de autenticación: Ese token será necesario para el resto de peticiones como cabecera

HeaderValor
apikey{{token}}

1. Token de Sesión​

El token de sesión tiene una validez de 48 horas y se utiliza para operaciones temporales.

Endpoint​

POST api/login

curl -X POST "https://app.konverting.io/api/login" -H "Content-Type: application/json" -d '{"username": "user", "password": "pass"}'

Cuerpo RAW de la solicitud​

{
  "email": "usuario@dominio.com",
  "password": "contraseña"
}

Parámetros de la solicitud​

  • username (string): Usuario de la plataforma.

    • Ejemplo: "JohnDoe@gmail.com"

  • password (string): Contraseña del usuario.

    • Ejemplo: "pa$$w0rd"

Respuesta de la API​

200 Respuesta​
{
    "id": "{{USER_ID}}",
    "username": "JohnDoe@gmail.com",
    "token": "{{TOKEN}}",
    "name": "John Doe",
    "avatar": "",
    "role": "Manager",
    "RGPD": true
}

401 No Access​
{
  "error": "No Access""
}

400 No data​
{
  "error": "No data""
}

500 Error​
{
  "error": "Error al realizar la peticion"
}

2. Token de Cuenta​

Este token no caduca y puede usarse para cualquier operación en el sistema. Puedes crearlo o revocarlo desde tu cuenta en Konverting. Tiene que terne un formato similar a pat-konverting-xxxxxxxx