Para empezar a usar la API de emBlue primero debemos tener en cuenta los pasos previos a la utilización de la misma como la creación de un usuario y el entendimiento del concepto de emBlue. Es importante que antes de utilizar la API el usuario conozca el vocabulario y el significado que, por ejemplo, emBlue le da a los envíos (acción).
- El equipo de soporte de emBlue le dará acceso a la Api proporcionando el Token para comenzar a utilizarla.
- Para comprender en concepto a emBlue se recomienda que el cliente primero utilice la herramienta desde la Interfaz de usuario para comprender las diferentes opciones de segmentación de contactos, cómo se crea una acción, a qué llama emBlue campañas, etc.
- Para utilizar este documento el cliente si o si debe tener un conocimiento básico de programación y entender la interfaz de usuario de emBlue (app.embluemail.com).
Paso 1> Autenticación:
La autenticación deberá invocarse únicamente al principio de la aplicación, quien generará un token que permitirá autenticar las futuras llamadas a las distintas funciones.
Este token tiene un tiempo de expiración de 30 minutos; una vez caducado el sistema deberá solicitarle a emBlue uno nuevo para poder continuar operando. Fuera de la autentificación, todas las funciones para solicitar datos consultan a CheckConnection. Si el resultado es verdadero la función va a poder ejecutar su rumbo normal, en caso contrario devolverá el error.
Qué es el Token?
La llave de acceso que EmBlue le otorga a un usuario o cliente para poder utilizar la aplicación. Este Token es el que utilizaremos para poder realizar cualquier actividad dentro de la API (crear campañas, acciones y agregar contactos).
Llamada por POST:
- Project Name: PruebaAPIMariana
- Initial WSDL: http://api.embluemail.com/Services/Emblue3Service.svc?wsdl
Autenticación:
INPUT:
- Token: PLQT3UC-n9DHY-s5qcA-Z084ZMUbag (otorgado por emblue)
- Usuario: mariana.c@embluemail.com
- Pass: 123
OUTPUT:
- Token dinámico: 4pRhW0ds-33Cij-EHM0h-qW03YBGSdz, es el que usaremos para realizar las distintas operaciones dentro de la API.
Llamada por REST:
Misma operación desde la UI:
- Interfaz de usuario: app.embluemail.com
- Usuario: mariana.c@embluemail.com
- Pass: 123