Post on 21-Feb-2017
TUTORIAL #DOPPLERACADEMY
CPO en Doppler
Diego Noya
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
Cómo aprovechar la API de Doppler
Cómo aprovechar la API | Diego Noya
#DopplerAcademy |
• Es un conjunto de reglas y funciones (Marco) que dan
acceso a determinada lógica de un software.
• Tiene una interface o un lenguaje definido.
• Define qué hacen y los resultados que devuelven pero
ocultan cómo lo hacen.
• Distintas aplicaciones usan este marco para poder
comunicarse entre ellas.
• Forma de reutilizar código.
¿Qué es y para qué sirve? API = Application Programming interface
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
Ventajas de REST
•Está totalmente bajo el estándar HTTP.
•Se pueden consumir fácilmente desde cualquier lenguaje de
programación.
•Es más “liviana” por lo que tiene muy buen rendimiento para
grandes volúmenes de datos.
•REST puede estar basada en XML o JSON para el formato de
Datos.
•La gran mayoría de las APIs nuevas, están hechas en REST
Ventajas de SOAP
•Los datos están bien estructurados y más orientados a
objetos.
•Funciona sobre diferentes protocolos, no solo por HTTP.
Diferencias entre SOAP y REST
La versión anterior de la API de Doppler está hecha con SOAP, la nueva API está realizada en REST
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
• Ofrecer más funcionalidades a nuestros clientes.
• Integraciones (Salesforce, Magento)
• Velocidad y escabilidad.
• Establecer una API moderna con más posibilidades que la API actual.
• Expansión, plataformas nuevas o integraciones con otros productos.
¿Por qué una versión nueva?
Hay muchos tipos de beneficios por usar las API, tanto para quien crea la misma, como para quien la utiliza
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
• Personas con conocimientos básicos/medios de programación.
• Empresas con un departamento de sistemas.
¿A quién está orientada?
El universo de quien puede utilizar la API es bastante variado, pero puede ser aprovechada por:
Como aprovechar la API | Diego Noya #DopplerAcademy |
¿Para qué? • Usarlo con un formulario e insertar un Suscriptor a una Lista.
• Automatizar procesos entre sistemas del usuario y Doppler.
• Consumir Reportes de una Campaña.
• Importar una Lista automáticamente
• Enviar una Campaña sin intervención de una persona ( avanzado )
• Tener una cuenta paga de Doppler
• Obtener el API Key de la cuenta
• Account Name de la cuenta (email de la cuenta)
Requerimientos para utilizarla
Como aprovechar la API | Diego Noya #DopplerAcademy |
• Sobre Doppler API
• Primeros Pasos
• Autentificación y API Key
• Usos básicos
• Manejo de errores
• Formatos de campos
•Definiciones Técnicas
•Playground
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
Primeros pasos
Antes de comenzar a utilizar la API es importante leer la documentación.
https://restapi.fromdoppler.com/docs/
Playground
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
El playground es una herramienta muy útil para realizar pruebas y asegurarnos que no estamos cometiendo
errores.
https://restapi.fromdoppler.com/docs/resources
Caso Práctico
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
A continuación vamos a utilizar el playground de la API para hacer un ejemplo sencillo.
• Crear una Lista (utilizando método List -> Post)
• Obtener esa Lista (usando API)
• Insertar un Suscriptor a la Lista (validar con la aplicación)
• Errores
Caso Práctico – Crear una Lista
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
{
"listId": 0,
"name": "Lista Webinar API",
"currentStatus": "ready",
"subscribersCount": 0,
"creationDate": "2016-07-27T01:12:03.919Z",
"deletedDate": "2016-07-27T01:12:03.919Z",
"hasScheduledCampaigns": false,
"hasFormsAssociated": false,
"hasSegmentsAssociated": false,
"hasEventsAssociated": false,
}
873418
Caso Práctico – Obtener la Lista
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
{
"listId": XXXXXX,
"name": "Lista Webinar API",
"currentStatus": "ready",
"subscribersCount": 0,
"creationDate": "2016-07-27T01:32:11.3530000+00:00",
…………..
}
Caso Práctico – Agregar en la Lista
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
{
"email": “email@example.com",
"belongsToLists": [
"string"
],
"status": "active",
"canBeReactivated": true,
"isBeingReactivated": true,
}
Caso Práctico – Errores
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
• Campo API Key vacío
Caso Práctico – Errores
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
• Campo API Key Incorrecto
¿Preguntas?
Cómo aprovechar la API | Diego Noya #DopplerAcademy |
CPO en Doppler
Diego Noya
dnoya@fromdoppler.com
¡GRACIAS!