Libraesva Email Security Gateway expone un conjunto de Application Programming Interface.
Las APIs están siempre disponibles, la lista de todas las APIs disponibles se puede encontrar dentro de ESG en la ruta /api/v2/ tras la autenticación.
Ejemplo: demo.esvacloud.com/api/v2/
Puede interactuar con las APIs directamente desde la página de documentación autenticándose con el botón "Authorize" en la parte superior derecha de la página; esta autenticación requiere un API Token válido.
Para generar un API Token debe realizarse un login en el endpoint /api/v2/login, que devolverá un API Token válido que se puede utilizar para realizar otras llamadas a la API.
El API Token generado heredará los permisos del Usuario especificado para realizar la autenticación en el endpoint /login si se trata de un Usuario normal (presente en la tabla "User Management -> Users").
Para realizar una llamada a la API después del login, debe pasar el API Token en el encabezado "X-ESG-Auth-Token".
Si la autenticación se realiza con un API User ("User Management -> API Users"), después del /login inicial para generar el API Token debe especificar un Usuario de ESG a suplantar mediante el encabezado "X-Switch-User".
En este encabezado debe especificar el username del Usuario de ESG a suplantar; el API User que realiza la llamada hereda los permisos del usuario especificado para esta llamada a la API. Si no se especifica un usuario, se producirá un error 403; el API User no tiene permisos por defecto y solo puede realizar la llamada /login.
A continuación puede ver los encabezados que deben rellenarse al pulsar el botón "Authorize" para realizar llamadas a la API directamente desde dentro de ESG.
