La autenticación es el primer paso antes de usar cualquier punto final de la API de Lengow. Debe hacerse en cada conexión.
Paso 1: Credenciales del cliente
Cualquier socio que desee interactuar con la API de Lengow necesitará un conjunto de credenciales (una ID de cuenta de Lengow, un token de acceso y un clientSecret), que se pueden encontrar a través del panel de control de Lengow.
Dónde encontrar estas claves API en Lengow:
- Inicia sesión en tu cuenta de Lengow
- Abre la página de configuración desde tu perfil > "Información general"
- Encuentra la sección llamada "A.P.I". my.lengow.io/company/api
- Puedes copiar el token de acceso y el secreto que se muestran en esta sección (ver imagen abajo)
¿Necesitas renovar tus claves API de Lengow?
Para obtener un nuevo token de acceso y un nuevo secreto, lee la FAQ dedicada:
💡 API - ¿Cómo renovar mi clave API de Lengow?
Si estabas usando estas claves API por tu cuenta, recuerda reemplazar las obsoletas.
Paso 2: Adquirir un token de acceso
A continuación, es adquirir un token de acceso de nuestro servicio de autenticación y establecer esto como un Encabezado de autorización al hacer llamadas a la API de Lengow.
1.Configura tu entorno de identificación en Postman
Para solicitar un token, comienza creando el encabezado de autorización.
- Para hacerlo, completa tus credenciales de cliente usando Postman y crea tu entorno.
2.Solicitando el token de acceso
Después de configurar el encabezado de autorización, solicita un token haciendo un POST:
POST /access/get_token
El servidor devuelve una respuesta como esta:
{
"token": "1895caa9-94d3-4ff6-ac9a-5b74a0e5a1b7",
"account_id": 1
} 3. Completa el entorno de identificación con el token de acceso
Abre de nuevo tu entorno en Postman y añade una nueva variable '"LENGOW_AUTH" con el token generado (ver imagen - fuente: Postman)
Nota: Si las credenciales no se han proporcionado correctamente, recibirás una respuesta 401 No autorizado del servidor.
Una vez que tienes tu token, todas tus solicitudes de API necesitarán un encabezado de autorización activo (Usa el entorno que creaste en Postman por ejemplo).
