El API de Alegra utiliza Basic Access como método de autenticación. Todos los request que se realicen deben incluir el header Authorization.
El acceso al API se realiza utilizando el correo y el token otorgado al usuario registrado en Alegra.
Obtener token de acceso
Debes seguir los siguientes pasos para obtener el token de acceso:
- Ingresar a aplicación Alegra.
- Haz clic sobre el vínculo "Configuración" en la parte superior derecha de la pantalla de Alegra y haz clic en la sección "API - Integraciones con otros sistemas"
- En la nueva pantalla puedes encontrar el correo con el cual debes acceder al API y el token. Si aún no cuentas con un token puedes generarlo también.
¿Cómo utilizar el token?
En el header Authorization se debe poner el correo y el token del usuario separado por dos puntos (:), todo en base64.
Por ejemplo, si el correo del usuario es [email protected] y el token es tokenejemploapi12345 el header Authorization debe quedar así :
Authorization: Basic ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1
Donde ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1 es base_64('[email protected]:tokenejemploapi12345')
Errores en autenticación
Si el API encuentra algún inconveniente con la autenticación retorna un código 401 y el error encontrado.