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 mostrados 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, simplemente haz clic en el botón "Renovar" presente en esta página (ver captura de pantalla).
Si estabas usando estas claves API en tu extremo, 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 401 No autorizado respuesta del servidor.
Una vez que tengas tu token, todas tus solicitudes de API necesitarán un encabezado de autorización activo (Usa el entorno que creaste en Postman por ejemplo).
