API - Autenticación

La autenticación es el primer paso antes de usar cualquier punto final de la API de Lengow. Debe hacerse en cada conexión.

En esta página describiremos los pasos que debes seguir para asegurarte de que tu aplicación pueda autenticarse contra la API de Lengow. Estamos usando Postman para nuestros ejemplos y descripciones.

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)

credentials.png

¿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.
renew.png

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)

auth_step2.png

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).

Este token que generas en cada nueva sesión será necesario para cualquier solicitud que envíes a la API. Cada token tiene una vida útil de 3600 segundos.
Por favor no solicites un nuevo token para cada solicitud a la API de Lengow! Los tokens son válidos por períodos de tiempo más largos y están destinados a ser reutilizados. No hacerlo puede sobrecargar el servicio de autenticación y llevará a una prohibición de IP cuando se excedan los límites de solicitud. Nota que los límites de velocidad para el servicio de autenticación son mucho más bajos que los de la API de Lengow.
D'accord, mais vous n'avez pas fourni de texte à traduire ou d'URL à modifier.
Este artículo ha sido traducido automáticamente. En caso de duda, le agradecemos que consulte las versiones originales en francés o en inglés.

Artículos en esta sección

Nuestros horarios de support:
De 9:00 a 18:30 CET de lunes a viernes