Documentación

Autenticación

En esta sección se encuentra información acerca del mecanismo de autenticación utilizado por la API de Alanube.

Para consumir la API de Alanube, tanto en el ambiente de sandbox como producción, se debe contar con un JWT (JSON Web Token) que será suministrado por Alanube. Puedes conocer más acerca de cómo obtener tu token de acceso acá.

Una vez obtenido dicho JWT, lo utilizaremos siguiendo el esquema de autenticación Bearer Authentication.

📘

¿Qué es Bearer Authentication?

Si es la primera vez que escuchas acerca de este esquema de autenticación, te contamos que se trata de un mecanismo de autenticación estándar en comunicaciones a través del protocolo HTTPS. Puedes leer más acerca de dicho esquema aquí.

En este modelo, dicho token se debe enviar en el header Authorization de las solicitudes hacia la API, precedido por la palabra Bearer.

A continuación, se muestra a modo de ejemplo como quedaría un request usando el JWT en el header:

curl --request GET \
     --url https://sandbox.alanube.co/dom/v1/company \
     --header 'accept: application/json' \
     --header 'authorization: Bearer my_secret_token'

Cabe aclarar, que el ejemplo presentado es a través de línea de comando y debe ser adaptado al correspondiente lenguaje de programación utilizado para la integración con la API.