APIs en MasterBase®

La principal ventaja de las APIs en Masterbase® radica en que permiten automatizar acciones que en la plataforma web se realizan en forma manual. Entre otras cosas, hacen posible:

Actualizar sus bases de datos en su ambiente de trabajo y en nuestra plataforma, simultáneamente.

Crear y enviar mensajes desde sus sistemas sin que deba ingresar a nuestra plataforma.

Recibir desde MasterBase® las métricas de sus envíos.

Nuestros web services API

Nuestros web service API

Utilice nuestros web services API para facilitar y sincronizar las acciones a realizar.

Cree sus credenciales API

Cree sus credenciales API

Antes de empezar debe crear las credenciales que le autorizan a hacer uso de nuestras APIs.

Integraciones API

Integraciones MasterBase®

Integre los sistemas internos de su empresa con nuestra plataforma y automatice el manejo de datos.

Comencemos con MasterBase®

Contacts »

MassiveMail »

UniqueMail »

Archive »

Config »

Content »

MasterBase® API

Para construir la URL del servicio que desea consumir, debe hacerlo con la siguiente estructura:

URL base que agrupa los servicios Contacts:

https://api2019.masterbase.com/

a la que debe agregar, en primer lugar, el segmento que indica el servicio al que apunta y, a continuación, los parámetros opcionales que definen su consulta en cuestión. El primero de ellos antecedido por un signo de interrogación (?), seguido por un signo igual (=) y el valor del parámetro. Desde el segundo parámetro que necesite añadir, deberá utilizar el signo ampersand (&) en lugar del signo de interrogación.

Ejemplo:

https://api2019.masterbase.com/contacts/v2/ClientName/?From=123&Top=100&Order=1

Estructura

The Envelope

Toda respuesta está contenida en una estructura denominada envelope (sobre, envoltorio). Esto significa, que cada respuesta tiene una estructura predefinida con las cuales se puede interactuar.

{
  "Service": "Nombre del servicio",
  "Version": "Version el servicio",
  "TransactionId": "Identificador alfanumerico de transaccion",
  "Status": {
    "Code": "Codigo de la respuesta",
    "Value": "Valor de la respuesta"
  },
  "Data": {}
}

Status

La llave status se utiliza para obtener información acerca de la respuesta del servicio. Si todo ha seguido su curso en forma correcta, la respuesta indicará en el atributo Code el valor 200 o 201. Sin embargo, puede ocurrir que algo falle, en cuyo caso la respuesta que se obtendrá es de este tipo:

"Status": {
  "Code": "401",
  "Value": "Unauthorized"
}

Aprenda más de las API MasterBase®

Contacts - Administre sus contactos

/contacts/v2/{ClientName}/{ListId}
Obtiene información de sus contactos.

/contacts/v2/{ClientName}/{ListId}
Elimina sus contactos de 1 en 1.

/contacts/v2/{ClientName}
Obtiene información de los envíos realizados a un contacto.

/contacts/v2/{ClientName}
Crea o actualiza sus contactos.

/contacts/v2/{ClientName}
Actualiza sus contactos de 1 en 1.

/contacts/v2/{ClientName}/GetContacts/{ListId}
Obtiene información de sus contactos por parámetros.

MassiveMail - Administre sus envíos

/massivemail/v1/{ClientName}
Realiza un envío masivo sin plantilla.

/massivemail/v1/{ClientName}
Realiza un envío masivo con plantilla.

/massivemail/v1/{ClientName}
Modifica un envío masivo.

/massivemail/v1/{ClientName}/GetMail
Obtiene el resumen de un envío por ID.

/massivemail/v1/{ClientName}/GetMails
Obtiene el resumen de un envío por parámetros.

/massivemail/v1/{ClientName}/GetStatistics
Obtiene las estadísticas de un envío.

/massivemail/v1/{ClientName}/GetEvent/{MailId}/{Event}
Obtiene detalles de los eventos relacionados con un envío.

UniqueMail - Administre sus envíos únicos

/UniqueMail/v3/{ClientName}
Realiza un envío único sin plantilla.

/UniqueMail/v3/{ClientName}
Realiza un envío único con plantilla.

/UniqueMail/v3/{ClientName}/Summary
Obtiene el resumen de sus envíos.

/UniqueMail/v3/{ClientName}/Statistics
Obtiene las estadísticas de sus envíos.

Archive - Accede a la URL de almacenamiento de tus campañas enviadas

/Archive/v1/{ClientName}/GetByRange
Obtiene la ULR del EML enviado, por rango de fechas y número de página.

/Archive/v1/{ClientName}/GetByMailId
Obtiene la ULR del EML enviado, por ID de envío.

/Archive/v1/{ClientName}/GetByEmail
Obtiene la ULR del EML enviado, por correo electrónico del destinatario.

Config - Consulte los datos de configuración

/Config/v1/{ClientName}/Fields/{ListId}
Obtiene la información de los campos de una base.

Content - Administre los contenidos de su cuenta

/Content/v1/{ClientName}
Obtiene información de los contenidos de su cuenta.

/Content/v1/{ClientName}
Modifica estados y fechas de un contenido.

FeedHub - Cargue datos fuente en un contenedor

https://feedhub.masterbase.com/v1/{IdCliente}/{IdContainer}/{ClaveContenedor}
Realizar carga de datos fuente.

Si necesita nuestra ayuda, tome contacto con Customer Service haciendo clic Aquí