Autenticación

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:

  1. Ingresar a aplicación Alegra.
  2. 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"
  3. 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.