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.
Utilice nuestros web services API para facilitar y sincronizar las acciones a realizar.
Antes de empezar debe crear las credenciales que le autorizan a hacer uso de nuestras APIs.
Integre los sistemas internos de su empresa con nuestra plataforma y automatice el manejo de datos.
Para construir la URL del servicio que desea consumir, debe hacerlo con la siguiente estructura:
URL base que agrupa los servicios Web:
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
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"
}
Para el consumo de los web services que se disponen en este sitio, es necesario considerar que autenticación de acceso es básica y para lo cual se utilizan las Credenciales API – usuario y contraseña - las cuales se obtienen a través de su cuenta MasterBase®. El uso de estas dependerá del lenguaje escogido para el consumo de los servicios y es de responsabilidad de quien realice el mismo.
/contacts/v2/{ClientName}/{ListId}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId *
Identificador de la base de contactos.
number($string) - (path)
Email *
Correo electrónico del contacto a buscar.
string($string) - (query)
From *
Indica el ID del primer contacto del listado.
string($string) - (query)
Top *
Indica la cantidad de contactos que muestra la lista.
string($string) - (query)
Order *
Indica el orden del listado: Por fecha de creación del contacto (0 ascendente, 1 descendente).
string($string) - (query)
(*) Parámetro obligatorio
Email, From, Top y Order son parámetros para incluir en el consumo de un web service. respetando las siguientes premisas:
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"idContact": "451028",
"Email": "example@mail.com",
"Gender": "M",
"CreatedBy": "Usuario",
"ModifiedBy": "Admin",
"DateModification": "2018-01-17T20:23:34.193",
"FieldStr01": "John",
"FieldStr02": "Doe",
"FieldDte01": "1900-01-01T00:00:00"
}
]
}
}
}
400
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/contacts/v2/{ClientName}/{ListId}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId *
Identificador de la base de contactos.
number($integer) - (path)
Identifier *
Correo electrónico o Identificador del contacto a buscar.
string($string) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contact": {
"Email": "prueba46@prueba.cl",
"Deleted": "True"
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Description
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/contacts/v2/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ContactId *
Identificador del contacto.
number($integer) - (query)
Order
Indica el orden en que se listará los envíos: Por fecha de envío.
integer - (query)
ExtraDetail
Indica si se requiere detalles de los envíos realizados (true/false).
boolean - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Response": {
"PageDetail": {
"TotalRecords": "340",
"CurrentPage": "1",
"TotalPage": "23"
},
"Summary": {
"TotalOpens": "45",
"TotalWebViews": "1",
"TotalCliks": "23",
"TotalBounces": "23"
},
"Mails": {
"Mail": [{
"id": "1022",
"Open": "2",
"WebView": "1",
"TotalClicks": "0",
"TotalBounces": "0",
"Detail": {
"Links": {
"Link": {
"Url": "http://www.es.masterbase.com/?utm_campaign=4329:%20Ejemplo%20&utm_source=MasterBase%20Cliente&utm_medium=email&utm_content=3&utm_term=none",
"Total": "1"
}
},
"Bounces": {
"Bounce": {
"Code": "133",
"Total": "1"
}
}
},
"ExtraDetail": {
"Opens": {
"Open": {
"Country": "US",
"OS": "Linux",
"Patform": "Desktop",
"EventDate": "2016-09-02T16:45:11"
}
},
"Clicks": {
"Click": {
"Country": "US",
"OS": "Linux",
"Patform": "Desktop",
"EventDate": "2016-09-02T16:45:11"
}
}
}
}
]
}
}
}
}
400
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/contacts/v2/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
Update
Indica si desea actualizar contactos (true/false).
boolean - (query)
Body *
Datos del contacto a crear o actualizar.
(body)
Example Value | Model
{
"Request": {
"ListId": "1",
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"Gender": "M",
"FieldStr01": "John",
"FieldStr02": "Doe",
"FieldDte01": "1900-01-01T00:00:00"
}
]
}
}
}
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "a7ef3fd03ad54fdc8394497ff6b74f9c",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"idContact": "451028",
"Validation": {
"Status": "PASSED"
},
"Operation": {
"Status": "UPDATED",
"text": "Successfully executed"
}
}
]
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Description
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/contacts/v2/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
Body *
Datos del contacto a actualizar.
(body)
Example Value | Model
{
"Request": {
"ListId": "1",
"Contact": {
"Email": "example@mail.com",
"Gender": "M",
"FieldStr01": "John",
"FieldStr02": "Doe",
"FieldDte01": "1900-01-01T00:00:00"
}
}
}
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "a7ef3fd03ad54fdc8394497ff6b74f9c",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"idContact": "451028",
"Validation": {
"Status": "PASSED"
},
"Operation": {
"Status": "UPDATED",
"text": "Successfully executed"
}
}
]
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Description
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/contacts/v2/{ClientName}/GetContacts/{ListId}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId *
Identificador de la base de contactos.
integer($int32) - (path)
Field*
Campo del filtro.
string - (query)
Value*
Valor a filtrar.
string - (query)
Top
Indica la cantidad de contactos que mostrará el listado.
string($string) - (query)
Op*
Operador que aplicará el filtro.
string - (query)
PageNumber
Operador que aplicará el filtro.
string - (query)
PageSize
Cantidad de registros a mostrar por página.
string - (query)
Order
Indica el orden en que se listará los envíos: Por fecha de creación.
string - (query)
(*) Parámetro obligatorio
Valores permitidos para el atributo del operador
Valor Operador
Correlación
Type
eq
Igual a
string - (query)
neq
Distinto a
string - (query)
sw
Empieza con
string - (query)
contain
Contiene
string - (query)
notcontains
No contiene
string - (query)
gt
Mayor que
string - (query)
Lt
Menor que
string - (query)
gte
Mayor o igual que
string - (query)
lte
Menor o igual que
string - (query)
null
Nulo
string - (query)
notnull
No Nulo
string - (query)
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"PageDetail": {
"CurrentPage": "1",
"TotalPages": "2323",
"TotalRecords": "5342",
"Contacts": {
"Contact": [{
"idContact": "451028",
"Email": "example@mail.com",
"Gender": "M",
"CreatedBy": "Usuario",
"ModifiedBy": "Admin",
"DateModification": "2018-01-17T20:23:34.193",
"FieldStr01": "John",
"FieldStr02": "Doe",
"FieldDte01": "1900-01-01T00:00:00"
}
]
}
}
}
}
400
No Data
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Code": "NoData",
"Value": "No Data"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "5c60b7bcd4f5620f627d0346b796c765",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFound",
"Value": "User not found"
}
}
500
Internal error
Example Value | Model
{
"Message": "An error has occuried"
}
/massivemail/v1/{ClientName}
Parameters endpoints
Name
Description
Type
Nombre de la cuenta. *
Nombre de la cuenta del cliente.
string($string) - (path)
Body *
Datos del mensaje a enviar.
(body)
Parameters body
Classification.
Sólo acepta valores “C” o “T” (Comercial/Transaccional) por defecto se asume Comercial.
Text
Name. *
Nombre del envío.
Text
Description.
Descripción del envío.
Text
SubCategoryId.
Identificador de subcategoría.
Number
Based on Type.
Sólo acepta valor “template”.
Text
Based on Id.
Identificador de la plantilla.
Number
From Type. *
Solo acepta valores "Standard" o “Dynamic”.
Text
From Id. *
Identificador numérico de remitente.
Number
ListId. *
Identificador de la lista de contactos sobre la cual se realizará el envío.
Number
FilterType. *
Sólo acepta valores “Static”, “Dynamic” o “Newsletter”.
Text
Ids. *
Listado de identificadores asociados al filtro seleccionado, solo permite múltiples identificadores el tipo de filtro Newsletter (boletín).
Number
Subject. *
Asunto del mensaje.
Text
Format. *
Solo acepta valores “html” o “text”.
Text
Now. *
Sólo acepta valores “true” o “false”, asume valor true por defecto.
Text
OpenTracking. *
Sólo acepta valores “true” o “false”.
Text
ClickTracking. *
Sólo acepta valores “true” o “false”.
Text
Enable. *
Sólo acepta valores “true” o “false”.
Text
La plantilla utilizada debe tener en el cuerpo del mensaje el tag ‹ attachfile /› y el fichero a adjuntar debe ser cargado previamente en el sistema vía File Bunker.
Example Value | Model
{
"GeneralData": {
"Name": "Prueba de Envio",
"Description": "Dato Opcional",
"SubCategory": "1",
"Classification": "C"
},
"From": {
"Type": "Standard",
"Id": "1"
},
"To": {
"Ids": [
"4"
],
"ListId": "1",
"FilterType": "Dynamic"
},
"Message": {
"Subject": "Asunto del correo",
"Body": {
"Format": "html",
"Value": "<!DOCTYPE html><html> Cuerpo del correo <html>"
}
},
"Options": {
"SendDate": {
"Now": "false",
"Value": "2018-01-30T09:38:00-03:00"
},
"OpenTracking": "true",
"ClickTracking": "true",
"Enable": "false"
}
}
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "a7ef3fd03ad54fdc8394497ff6b74f9c",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"idContact": "451028",
"Validation": {
"Status": "PASSED"
},
"Operation": {
"Status": "UPDATED",
"text": "Successfully executed"
}
}
]
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}
Parameters endpoints
Name
Description
Type
Nombre de la cuenta. *
Nombre de la cuenta del cliente.
string($string) - (path)
Body *
Datos del mensaje a enviar.
(body)
Parameters body
Classification.
Sólo acepta valores “C” o “T” (Comercial/Transaccional) por defecto se asume Comercial.
Text
Name. *
Nombre del envío.
Text
Description.
Descripción del envío.
Text
SubCategoryId.
Identificador de subcategoría.
Number
Based on Type.
Sólo acepta valor “template”.
Text
Based on Id.
Identificador de la plantilla.
Number
From Type. *
Solo acepta valores "Standard" o “Dynamic”.
Text
From Id. *
Identificador numérico de remitente.
Number
ListId. *
Identificador de la lista de contactos sobre la cual se realizará el envío.
Number
FilterType. *
Sólo acepta valores “Static”, “Dynamic” o “Newsletter”.
Text
Ids. *
Listado de identificadores asociados al filtro seleccionado, solo permite múltiples identificadores el tipo de filtro Newsletter (boletín).
Number
Subject. *
Asunto del mensaje.
Text
Format. *
Solo acepta valores “html” o “text”.
Text
Now. *
Sólo acepta valores “true” o “false”, asume valor true por defecto.
Text
OpenTracking. *
Sólo acepta valores “true” o “false”.
Text
ClickTracking. *
Sólo acepta valores “true” o “false”.
Text
Enable. *
Sólo acepta valores “true” o “false”.
Text
La plantilla utilizada debe tener en el cuerpo del mensaje el tag ‹ attachfile /› y el fichero a adjuntar debe ser cargado previamente en el sistema vía File Bunker.
Según se entregue u omita un valor para el parámetro Subject, el servicio tomará el valor dado o asumirá como asunto el de la plantilla seleccionada.
Example Value | Model
{
"GeneralData": {
"Name": "Correo promocional campaña Noviembre",
"Description": "Correo que contiene la campaña promocional de nov.",
"SubCategoryId": "2",
"Classification": "C",
"BasedOn": {
"Type": "template",
"Id": "1"
}
},
"From": {
"Type": "Standard",
"Id": "1"
},
"To": {
"Ids": [
"1"
],
"ListId": "1",
"FilterType": "Newsletter"
},
"Message": {
"Subject": "Campaña Noviembre",
"Body": {
"Format": "html",
"Value": "<!DOCTYPE html><html> Cuerpo del correo <html> "
}
},
" Options ": {
" SendDate ": {
" now ": " false ",
" value ": " 2016 - 09 - 05 20: 30: 00 "
},
" OpenTracking ": " false ",
" ClickTracking ": " true ",
" Enable ": " true "
}
}
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "a7ef3fd03ad54fdc8394497ff6b74f9c",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"idContact": "451028",
"Validation": {
"Status": "PASSED"
},
"Operation": {
"Status": "UPDATED",
"text": "Successfully executed"
}
}
]
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
Body *
Datos a actualizar en el borrador generado.
(body)
Example Value | Model
{
"GeneralData": {
"MailId": "5401",
"SubcategoryId": "2"
},
"From": {
"Type": "Standard",
"Id": "1"
},
"To": {
"Ids": [
"4"
],
"ListId": "1",
"FilterType": "Dynamic"
},
"Message": {
"Subject": "Asunto del correo",
"Body": {
"Format": "html",
"Value": "<!DOCTYPE html><html> Cuerpo del correo <html>"
}
},
"Options": {
"SendDate": {
"Now": "false",
"Value": "2018-01-30T09:38:00-03:00"
},
"OpenTracking": "true",
"ClickTracking": "true",
"Enabled": "false"
}
}
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"MailId": {
"AccountStatus": "User",
"Value": "10291"
},
"TransactionId": "RST01_20180130_44c2af5ef1984651bf9f0aad1264b2df",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
Description
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}/GetMail
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
MailId *
Identificador del envío.
integer($int64) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Response": {
"AccountTipe": "T",
"MassiveMail": {
"Id": "7024",
"Name": "Nombre del envio",
"Subject": "Asunto del envio",
"Status": "E",
"Creator": "email@dominio.com",
"SentDate": "2017-08-09T13:25:01.717",
"EnabledBy": "email@dominio.com",
"EnabledDate": "2017-08-09T13:25:01.717",
"Total": "1000",
"CategoryId": "1",
"Category": "Categoria Test",
"SubCategoryId": "1",
"SubCategory": "Test Interno"
}
},
"TransactionId": "RST01_20180130_44c2af5ef1984651bf9f0aad1264b2df",
"Status": {
"Code": "200",
"Value": "OK"
}
}
AccountType
Tipo de credencial que originó el mensaje
T: Testing / Restringida P: Productiva
ID
Identificador numérico del mensaje.
-
Name
Nombre asignado al mensaje.
-
Subject
Asunto del mensaje.
-
Status
Estado del mensaje.
E: Enviado
D: Deshabilitado
H: Habilitado
Creator
Credencial que creo el mensaje.
-
SentDate
Fecha de envío.
-
EnabledBy
Credencial que habilitó el mensaje.
-
EnabledDate
Fecha de habilitación del mensaje.
-
Total
Cantidad de destinatarios.
-
CategoryId
Id de la categoría asignada al envío.
-
Category
Nombre de la categoría asignada al envío.
-
SubCategoryId
Id de la subcategoría asignada al envío.
-
SubCategory
Nombre de la subcategoría asignada al envío.
-
400
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}/GetMails
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string - (path)
PageNumber
Número de página a la vista.
string - (query)
PageSize
Cantidad de registros por página.
string - (query)
StartDate
Fecha inicial del listado de envíos.
string - (query)
EndDate
Fecha final del listado de envíos.
string - (query)
CategoryId
Identificador de la categoría del envío.
integer($int32) - (query)
SubCategoryId
Identificador de la subcategoría del envío.
integer($int32) - (query)
Creator
Correo electrónico o credencial del creador del envío.
string - (query)
EnabledBy
Correo electrónico o credencial del habilitador del envío.
string - (query)
Subject
Asunto del envío.
string($string) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Response": {
"AccountTipe": "T",
"MassiveMail": {
"Id": "7024",
"Name": "Nombre del envio",
"Subject": "Asunto del envio",
"Status": "E",
"Creator": "email@dominio.com",
"SentDate": "2017-08-09T13:25:01.717",
"EnabledBy": "email@dominio.com",
"EnabledDate": "2017-08-09T13:25:01.717",
"Total": "1000",
"CategoryId": "1",
"Category": "Categoria Test",
"SubCategoryId": "1",
"SubCategory": "Test Interno"
}
},
"TransactionId": "RST01_20180130_44c2af5ef1984651bf9f0aad1264b2df",
"Status": {
"Code": "200",
"Value": "OK"
}
}
AccountType
Tipo de credencial que originó el mensaje
T: Testing / Restringida P: Productiva
ID
Identificador numérico del mensaje.
-
Name
Nombre asignado al mensaje.
-
Subject
Asunto del mensaje.
-
Status
Estado del mensaje.
E: Enviado
D: Deshabilitado
H: Habilitado
Creator
Credencial que creo el mensaje.
-
SentDate
Fecha de envío.
-
EnabledBy
Credencial que habilitó el mensaje.
-
EnabledDate
Fecha de habilitación del mensaje.
-
Total
Cantidad de destinatarios.
-
CategoryId
Id de la categoría asignada al envío.
-
Category
Nombre de la categoría asignada al envío.
-
SubCategoryId
Id de la subcategoría asignada al envío.
-
SubCategory
Nombre de la subcategoría asignada al envío.
-
400
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}/GetStatistics
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string - (path)
MailId
Identificador del envío.
integer($int64) - (query)
PageNumber
Número de página a la vista.
string - (query)
PageSize
Cantidad de registros por página.
string - (query)
StartDate
Fecha inicial del listado de envíos.
string - (query)
EndDate
Fecha final del listado de envíos.
string - (query)
CategoryId
Identificador de la categoría del envío.
integer($int32) - (query)
SubCategoryId
Identificador de la subcategoría del envío.
integer - (query)
EnabledBy
Correo electrónico o credencial del habilitador del envío.
string($int32) - (query)
Creator
Correo electrónico o credencial del creador del envío.
string - (query)
EnabledBy
Correo electrónico o credencial del habilitador del envío.
string - (query)
Subject
Asunto del envío.
string - (query)
ExtraDetail
Indica si se obtendrá estadísticas detalladas.
boolean - (query)
Order
Indica el orden del listado: Por fecha de envío (0 ascendente, 1 descendente).
string($string) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Response": {
"AccountType": "T",
"CurrentPage": "1",
"TotalPage": "500",
"TotalRecords": "3200",
"MassiveMail": {
"Statistics": [{
"MailId": "10234",
"Sent": "1000",
"Open": "700",
"OpenUnique": "450",
"OpenPixelTracking": "45",
"OpenWebview": "1",
"OpenClicDeduced": "23",
"Bounce": "2",
"BounceUnique": "2",
"Click": "333",
"ClickUnique": "163",
"NotOpen": "300",
"Accepted": "689",
"Acepted_Rate": "98.0000",
"TAC": "75.0000",
"CTR": "75.0000",
"CTO": "75.0000",
"ExtraDetail": {
"Opens": [{
"OpenDetail": "101",
"Country": "US",
"OS": "Linux",
"Patform": "Desktop",
"EventDate": "2016-09-02T16:45:11"
}
],
"Links": [{
"OpenDetail": "101",
"Country": "US",
"OS": "Linux",
"Patform": "Desktop",
"EventDate": "2016-09-02T16:45:11"
}
],
"Bounces": [{
"OpenDetail": null,
"Country": null,
"OS": null,
"Patform": null,
"EventDate": "2016-09-02T16:45:11"
}
]
}
}
]
}
},
"TransactionId": "RST04_20180201_bfb8cbfaf1ff45528b0073cbaae06805",
"Status": {
"Code": "200",
"Value": "OK"
}
}
AccountType
Tipo de credencial que originó el mensaje
T: Testing / Restringida P: Productiva
CurrentPage
Número de página a la vista.
-
TotalPage
Total páginas de respuesta.
-
TotalRecords
Total casillas destinatarias.
-
MailId
Identificador numérico del mensaje.
-
Sent
Cantidad de envíos realizados.
-
Open
Cantidad total de mensajes abiertos.
-
OpenUnique
Cantidad de aperturas únicas.
-
OpenPixelTracking
-
-
OpenWebview
Cantidad de mensajes visualizados vía web.
-
OpenClicDeduced
-
-
Bounce
Cantidad total de rebotes.
-
BounceUnique
Cantidad de rebotes únicos.
-
Click
Cantidad total de link abiertos.
-
ClickUnique
Cantidad de link únicos abiertos.
-
Accepted
Cantidad de mensajes aceptados.
-
Accepted_Rate
Porcentaje de aceptación de mensajes.
-
NotOpen
Cantidad de mensajes no abiertos.
-
Accepted
Cantidad de mensajes aceptados.
-
Acepted_Rate
Tasa de aceptados.
-
TAC
Tasa de aperturas únicas.
-
CTR
Clics únicos/Mensajes aceptados = Unique Click Trough Rate.
-
CTO
Clics únicos/Pixel tracking = Unique Click To Open.
-
ExtraDetail
Detalles extras sobre los eventos.
Opens
Links
Bounce
OpenDetail
Código asociado al evento.
-
Country
Sigla de país en que se produjo el evento.
-
OS
Sistema operativo desde el cual se produjo el evento.
-
Platform
Plataforma.
Desktop
Mobile
EventDate
Fecha asociada al evento.
-
400
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/massivemail/v1/{ClientName}/GetEvent/{MailId}/{Event}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string - (path)
MailId*
Identificador del envío.
integer($int64) - (path)
Event *
Tipo de evento (sent, open, click, bounce)
string - (path)
PageNumber
Número de página a la vista.
string - (query)
PageSize
Cantidad de registros por página.
string - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Response": {
"CurrentPage": "1",
"TotalPage": "1",
"TotalRecords": "1",
"Records": {
"Type": "open",
"Record": [
{
"Email": "correo@mail.com",
"EventDate": "2018-02-08T15:52:46",
"OperatingSystem": "Windows 7",
"Platform": "WinNT"
}
]
}
},
"TransactionId": "RST04_20180201_bfb8cbfaf1ff45528b0073cbaae06805",
"Status": {
"Code": "200",
"Value": "OK"
}
}
AccountType
Tipo de credencial que originó el mensaje
T: Testing / Restringida P: Productiva
CurrentPage
Número de página a la vista.
-
TotalPage
Total páginas de respuesta.
-
TotalRecords
Total casillas destinatarias.
-
Type
Tipo de evento.
Opens
Links
Bounce
Casilla asociada al evento.
-
EventDate
Fecha asociada al evento.
-
OperatingSystem
Sistema operativo desde el cual se produjo el evento.
-
Platform
Plataforma.
Desktop
Mobile
400
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/UniqueMail/v3/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
Body *
Datos del mensaje a enviar.
(body)
Example Value | Model
{
"GeneralData": {
"FromName": "Nombre Remitente",
"From": "from@mail.com",
"To": {
"Email": [
"destinatario@mail.com"
]
},
"Cc": {
"Email": [
"destinatarioCC@mail.com"
]
},
"Bcc": {
"Email": [
"destinatarioBcc@mail.com"
]
},
"Message": {
"Subject": "Asunto del correo",
"Classification": "T",
"Body": {
"Format": "html",
"Value": "<!DOCTYPE html><html> Cuerpo del correo <html>"
},
"Attachment": [
{
"FileName": "a-b-c.csv",
"Encode": "Base64",
"Size": "1",
"Value": "ZW1haWw7bm9tYnJlDQphQGEuY29tO2ENCmJAYi5jb207Yg0KY0BjLmNvbTtjDQo="
}
]
},
"Options": {
"OpenTracking": "true",
"ClickTracking": "true",
"TextHtmlTracking": "true",
"AutoTextBody": "false"
}
}
}
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"Mails": [{
"Id": "W1C1d18d0b1cb52e4a2fa89d19af3fe9b44601"
}
]
},
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
Description
No Data
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Code": "NoData"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFoundOrWithoutPermissions"
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Code": "GeneralException"
}
}
/UniqueMail/v3/{ClientName}
Parameters endpoints
Name
Description
Type
Nombre de la cuenta. *
Nombre de la cuenta del cliente.
string($string) - (path)
Body *
Datos del mensaje a enviar.
(body)
Example Value | Model
{
"GeneralData": {
"FromName": "Nombre Remitente",
"From": "correo@remitente.com",
"To": {
"Email": ["emaildestintario1@mail.com", " emaildestintario2@mail.com "]
},
"Message": {
"Subject": "Asunto del envio",
"Classification": "C",
"BasedOn": {
"Id": "6",
"Type": "Template"
},
"Body": {
"Format": "html",
"Value": "obligatorio",
"Variables": [{
"Name": "VariableNombre",
"Value": "Claudia"
}, {
"Name": "VariableApellido",
"Value": "Carmona"
}, {
"Name": "VariableCargo",
"Value": "Editora de Contenidos"
}, {
"Name": "VariableCorreo",
"Value": "example@mail.com"
}
]
},
"Attachment": [{
"FileName": "NombreArchivo1.ext",
"Encode": "Base64",
"Size": "178",
"Value": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf/9k="
}, {
"FileName": "NombreArchivo2.ext",
"Encode": "Base64",
"Size": "165",
"Value": "/9j/4AAQSkZJRgABAQAAAQABAAD//LCk/ZWo7P5SrG7hNWz+X6j8hGbTeV3r9goypgENJdfYEIgQiBCIEIgQiBCIEIgQiBCIEIgQiBC//2Q=="
}
]
},
"Options": {
"OpenTracking": "true",
"ClickTracking": "false",
"TextHtmlTracking": "true",
"AutoTextBody": "false",
"Personalization": "true"
}
}
}
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Service": "Contacts",
"Version": "1.0.9.0",
"TransactionId": "a7ef3fd03ad54fdc8394497ff6b74f9c",
"Status": {
"Code": "200",
"Value": "OK"
},
"Data": {
"Contacts": {
"Contact": [{
"Email": "example@mail.com",
"idContact": "451028",
"Validation": {
"Status": "PASSED"
},
"Operation": {
"Status": "UPDATED",
"text": "Successfully executed"
}
}
]
}
}
}
400
Description
No Data
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Mensaje": {
"Code": "InternalWarning"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "400",
"Value": "BadRequest"
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Error": {
"Code": "InternalError"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "500",
"Value": "InternalServerError"
}
}
/UniqueMail/v3/{ClientName}/Summary
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
MailId
Identificador del envío.
integer($int64) - (query)
PageNumber
Número de página a la vista.
integer($int64) - (query)
PageSize
Cantidad de registros a mostrar.
integer($int64) - (query)
PageSize
Cantidad de registros por página.
string - (query)
StartDate
Fecha inicial del listado de envíos.
string - (query)
EndDate
Fecha final del listado de envíos.
string - (query)
To
Dirección de correo electrónico del destinatario.
string - (query)
Order
Indica el orden del listado: Por fecha de envío (0 ascendente, 1 descendente).
integer($int32) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"PageDetail": {
"TotalRecords": "1232",
"CurrentPage": "1",
"TotalPages": "10"
},
"Mails": [{
"Id": "A16415e5cb09bea04952bb0e09e25ca6802301",
"RuleId": "30",
"Subject": "Asunto del mensaje",
"From": "remitente@mail.com",
"To": "destinatario@mail.com",
"Category": "Categoria Test",
"UrlEmlOriginal": "https://api.masterosr.com/out/v1/4/4/A16415e5cb09bea04952bb0e09e25ca6802301/o8bhex6cee64lxu20xmubwz7yrbxniws",
"UrlEmlProced": "https://api.masterosr.com/out/v1/4/4/A16415e5cb09bea04952bb0e09e25ca6802301/2bugbxkq7f6fqs1ul7elz7lwdov71j",
"ReceptionDate": "2017-11-21T15:21:23.867",
"SendDate": "2017-11-21T15:19:21.51",
"Status": "250"
}
]
},
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Code": "NoData"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "MassiveMail",
"Version": "1.0.14.0",
"Error": {
"Message": {
"Code": "AuthorizationFailure"
}
},
"TransactionId": "RST02_20180130_62875e9908484fc9a56db8bdf3d407cd",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
}
}
500
Internal error
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Code": "GeneralException"
}
}
/UniqueMail/v3/{ClientName}/Statistics
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
MailId
Identificador del envío.
integer($int64) - (query)
PageNumber
Número de página a la vista.
integer($int64) - (query)
PageSize
Cantidad de registros a mostrar.
integer($int64) - (query)
StartDate
Fecha inicial del listado de envíos.
string - (query)
EndDate
Fecha final del listado de envíos.
string - (query)
To
Dirección de correo electrónico del destinatario.
string - (query)
Order
Indica el orden del listado: Por fecha de envío (0 ascendente, 1 descendente).
integer($int32) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"PageDetail": {
"TotalRecords": "1232",
"CurrentPage": "1",
"TotalPages": "10"
},
"Summary": {
"PageDetail": {
"Sents": "1",
"Opens": "1",
"Clicks": "2",
"Retries": "2",
"Accepteds": "1",
"AcceptedsRate": "100.0000",
"TACs": "0.0000",
"PCTRs": "0.0000",
"CTRs": "0.0000",
"PCTOs": "0.0000",
"CTOs": "0.0000"
}
},
"Mails": [{
"MailId": "A16415e5cb09bea04952bb0e09e25ca6802301",
"Retry": "2",
"Sents": "1",
"Opens": "1",
"Clicks": "2",
"Accepteds": "1",
"AcceptedsRate": "100.0000",
"TAC": "0.0000",
"PCTR": "0.0000",
"CTR": "0.0000",
"PCTO": "0.0000",
"CTO": "0.0000"
}
]
},
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Code": "NoData"
}
}
401
Unauthorized
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Code": "UserNotFoundOrWithoutPermissions"
}
}
500
Internal error
Example Value | Model
{
"Service": "UniqueMail",
"Version": "1.0.13.0",
"TransactionId": "INSTANCIA 03_20180222_6a7f91d0f6824457a58f89539721d8f7",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Code": "GeneralException"
}
}
/Archive/v1/{ClientName}/GetByRange
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
PageNumber
Número de página a la vista.
integer($int64) - (query)
PageSize
Cantidad de registros a mostrar.
integer($int64) - (query)
StartDate
Fecha inicial del listado de envíos.
string - (query)
EndDate
Fecha final del listado de envíos.
string - (query)
Order
Indica el orden del listado: Por fecha de envío (0 ascendente, 1 descendente).
integer($int32) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"PageDetails": {
"TotalRecords": "408",
"CurrentPage": "1",
"TotalPages": "204"
},
"Archives": {
"Archive": [{
"From": "remitente@mail.com",
"Serial": "25",
"MailId": "3099",
"Type": "0",
"IdResp": "111",
"MailUTCDate": "2016-12-15T13:34:14.973",
"ArchiveDate": "2017-01-05T21:40:18.700",
"Subject": "Asunto del envio",
"URL": "https://ss-scl01.masterosr.com/out/v1/AQ02B02/170102/CLIENTE/19/2016-12-15T10/CLIENTE.0.3099.25@sender19.masterbase.com.eml/e5897589e9e14ee9b53a10e7bad963a8"
}
]
}
},
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_01_20171102_e5897589e9e14ee9b53a10e7bad963a8",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Message": {
"Code": "NoData"
}
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Message": {
"Code": "UserNotFoundOrWithoutPermissions"
}
}
}
500
Internal error
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
/Archive/v1/{ClientName}/GetByMailId
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
MailId*
Identificador del envío.
integer($int64) - (query)
Order
Cantidad de registros a mostrar.
integer($int32) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"Archive": [{
"From": "remitente@mail.com",
"Serial": "25",
"MailId": "3099",
"Type": "0",
"IdResp": "111",
"MailUTCDate": "2016-12-15T13:34:14.973",
"ArchiveDate": "2017-01-05T21:40:18.700",
"Subject": "Asunto del envio",
"URL": "https://ss-scl01.masterosr.com/out/v1/AQ02B02/170102/CLIENTE/19/2016-12-15T10/CLIENTE.0.3099.25@sender19.masterbase.com.eml/e5897589e9e14ee9b53a10e7bad963a8"
}
]
},
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_01_20171102_e5897589e9e14ee9b53a10e7bad963a8",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Message": {
"Code": "NoData"
}
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
500
Internal error
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
/Archive/v1/{ClientName}/GetByEmail
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
Email*
Dirección de correo electrónico del destinatario.
integer($int64) - (query)
Order
Indica el orden del listado: Por fecha de envío (0 ascendente, 1 descendente).
integer($int32) - (query)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"Archive": [{
"From": "remitente@mail.com",
"Serial": "25",
"MailId": "3099",
"Type": "0",
"IdResp": "111",
"MailUTCDate": "2016-12-15T13:34:14.973",
"ArchiveDate": "2017-01-05T21:40:18.700",
"Subject": "Asunto del envio",
"URL": "https://ss-scl01.masterosr.com/out/v1/AQ02B02/170102/CLIENTE/19/2016-12-15T10/CLIENTE.0.3099.25@sender19.masterbase.com.eml/e5897589e9e14ee9b53a10e7bad963a8"
}
]
},
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_01_20171102_e5897589e9e14ee9b53a10e7bad963a8",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "200",
"Value": "OK"
},
"Error": {
"Message": {
"Code": "NoData"
}
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Message": {
"Code": "UserNotFoundOrWithoutPermissions"
}
}
}
500
Internal error
Example Value | Model
{
"Service": "Archive",
"Version": "1.0.2.0",
"TransactionId": "Archive_04_20171019_cd26038250174628b7ba8274930b12d6",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
/Config/v1/{ClientName}/Fields/{ListId}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId*
Identificador de la base de contactos.
integer($int32) - (path)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"Field": [{
"Id": "84",
"Name": "Email",
"Display": "Email",
"IntTtpe": "Str",
"Required": "1",
"MinLength": "1",
"MaxLength": "150",
"ReadOnly": 0,
"PersonalizationString": "#!Email!#"
}
]
},
"Service": "Config",
"Version": "1.0.3.0",
"TransactionId": "CONFIG_04_20180223_9c7f1617f4d6408e8bba266d82f102f8",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "Config",
"Version": "1.0.3.0",
"TransactionId": "CONFIG_04_20180223_839ad16e729b4c8fa5c11d3ac16abf72",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Message": {
"Code": "WarningException"
}
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Config",
"Version": "1.0.3.0",
"TransactionId": "CONFIG_04_20180223_839ad16e729b4c8fa5c11d3ac16abf72",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Message": {
"Code": "CredentialsNotFound"
}
}
}
500
Internal error
Example Value | Model
{
"Service": "Config",
"Version": "1.0.3.0",
"TransactionId": "CONFIG_04_20180223_839ad16e729b4c8fa5c11d3ac16abf72",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
/Content/v1/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId*
Identificador de la base de contactos.
integer($int32) - (path)
(*) Parámetro obligatorio
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": {
"Summary": {
"CurrentPage": 1,
"TotalPages": 1,
"TotalRecords": 1,
"Contents": [{
"Id": "84",
"Type": "Anuncio Inmobiliario",
"Name": "Inmobiliaria Saenz",
"CreationDate": "2017-03-21T14:17:11.287",
"Creator": "example@exmple.com",
"ModificationDate": "2017-03-21T14:17:11.287",
"Modificator": "example@exmple.com",
"EnableDate": "2017-03-21T14:17:11.287",
"ExpirationDate": "2017-03-21T14:17:11.287",
"Status": "2"
}
]
}
},
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_56078b29566c42d0a1c90a30074558fd",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
No Data
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Message": {
"Code": "WarningException"
}
}
}
401
Unauthorized
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Message": {
"Code": "CredentialsNotFound"
}
}
}
500
Internal error
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
/Content/v1/{ClientName}
Parameters endpoints
Name
Description
Type
ClientName *
Nombre de la cuenta.
string($string) - (path)
ListId *
Identificador de la lista de contactos.
integer($int32) - (path)
Body *
Datos del contacto a modificar.
(body)
Example Value | Model
{
"Id": "159",
"EnableDate": "2018-07-14T00:00:00",
"ExpirationDate": "2018-07-30T03:00:00",
"Status": "1"
}
Responses
Code
200
Description
Succesfull response
Example Value | Model
{
"Data": "Updated",
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_56078b29566c42d0a1c90a30074558fd",
"Status": {
"Code": "200",
"Value": "OK"
}
}
400
Description
No Data
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "400",
"Value": "BadRequest"
},
"Error": {
"Message": {
"Code": "WarningException"
}
}
}
401
Description
Unauthorized
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "401",
"Value": "Unauthoraized"
},
"Error": {
"Message": {
"Code": "CredentialsNotFound"
}
}
}
500
Description
Internal error
Example Value | Model
{
"Service": "Content",
"Version": "1.0.1.0",
"TransactionId": "CONTENT_20180713_0cf3566d77884022b1bc63298e312c92",
"Status": {
"Code": "500",
"Value": "InternalServerError"
},
"Error": {
"Message": {
"Code": "ErrorException"
}
}
}
https://feedhub.masterbase.com/v1/{IdCliente}/{IdContainer}/{ClaveContenedor}
Parameters endpoints
Name
Description
Type
IdCliente. *
Número identificador del cliente.
string($string) - (path)
IdContenedor. *
Identificador del contenedor.
string($string) - (path)
ClaveContenedor. *
Clave del contenedor.
string($string) - (path)
Body *
Datos del mensaje a enviar.
(body)
Example Value | Model
[{
"ListID": "identificador de lista de contactos",
"Email": "Email del contacto ",
"FieldStr01": "Nombre del contacto 1",
"FieldStr02": "Apellido paterno 1",
"FieldStr03": "Apellido materno 1",
"Gender": "Género1 (M/F)",
"FieldDte01": "Fecha nacimiento 1(AAAA-MM-DDTHH:MI:SS)",
"Campos_Personalizados": "Cualquier tipo de valor"
}, {
"ListID": "identificador de lista de contactos",
"Email": "Email del contacto 2",
"FieldStr01": "Nombre del contacto 2",
"FieldStr02": "Apellido paterno 2",
"FieldStr03": "Apellido materno 2",
"Gender": "Género2 (M/F)",
"FieldDte01": "Fecha nacimiento 2(AAAA-MM-DDTHH:MI:SS)",
"Campos_Personalizados": "Cualquier tipo de valor"
}
]
(*) Parámetro obligatorio
Responses
Code
201
Description
Succesfull response
Example Value | Model
{
"Service": "FeedHub",
"Version": "1.0.4.0",
"TransactionId": "FH01_20160926_6d6f109a991642b29824633115e4aa98",
"Status": {
"Code": "201",
"Value": "Created"
}
}