nxar.Aprender
Integraciones: hablá con otros sistemas0 de 6 capítulos
  1. 1Qué es una integración
  2. 2Tu primera integración
  3. 3Usar la respuesta en una automation
  4. 4Mandar datos a otro sistema
  5. 5Quién puede usarla
  6. 6Errores y registro de llamadas

Casos de uso

  1. ·Traer la cotización del dólar a una oportunidad
  2. ·Autenticación con bearer token
  3. ·Autenticación con usuario y contraseña (basic)
  4. ·API key en un header
  5. ·API key en la URL
  6. ·Una API que pide varios headers
  7. ·OAuth2 client credentials
  8. ·OAuth2 JWT bearer

← Volver al recorrido

Caso de uso · Integraciones: hablá con otros sistemas · 6 min

Autenticación con bearer token

La API te dio un token o una clave de acceso y pide mandarlo como Authorization: Bearer. Cómo cargarlo y cómo probarlo.

Cuándo. Es el tipo más común en APIs modernas. La documentación del servicio dice algo como “mandá el header Authorization: Bearer <tu token>”, y el token lo sacás de su panel: suele llamarse access token, API token o personal access token. El sistema de logística de Diego funciona así.

Qué hace Nxar. En cada llamada agrega el header Authorization: Bearer seguido del token. El token se guarda cifrado y no se vuelve a mostrar.

Para probarlo sin cuenta en ningún lado usamos https://httpbin.org/bearer, que contesta 200 si recibe un bearer token y 401 si no.

Probalo en un workspace de práctica

Un workspace con el escenario ya armado, que se borra solo a las 48 h. Estamos terminándolo.

Creá la integración

ConfiguraciónIntegraciones y APIIntegrations

Nueva Integration: Etiqueta Logística (bearer), Nombre logistica_bearer, Método GET, URL https://httpbin.org/bearer. Crear.

Probala sin autenticación

En Test, Ejecutar Test: la respuesta es 401 en rojo. Es lo esperable: todavía no le diste el token.

Cargá el token

Editar. En Autenticación, Tipo: Bearer token. En Token pegá aprender-token-123. Guardar.

Bloque Autenticación en edición con Tipo Bearer token y el campo Token enmascarado
El token se escribe enmascarado y se guarda cifrado.

La ficha no se refresca sola: volvé a la lista con la flecha y abrí Logística (bearer) de nuevo. Autenticación ahora dice Bearer token.

Probala de nuevo

Ejecutar Test. Ahora es 200 y httpbin te devuelve el token que recibió:

{
  "authenticated": true,
  "token": "aprender-token-123"
}
Ficha de la integración con Autenticación Bearer token y el Test en 200 mostrando authenticated true
Mismo Test, ahora con 200: el header llegó.

No escribas Bearer en el campo Token: Nxar ya lo agrega. Si lo pegás con la palabra adelante, el header sale como Bearer Bearer … y la API lo rechaza.

Para cambiar el token más adelante: Editar. El campo Token aparece con tres caracteres ocultos: es ***, la marca de que hay uno guardado. Dejalo así para conservar el actual, o borralo y pegá el nuevo.

Cómo saber que te salió

Sin token, Ejecutar Test da 401; con el token cargado, da 200 y "authenticated": true.

¿Te funcionó?