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" } }
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" } }
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" } }
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" } }
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://apirds2020.masterbase.com/find
Encontrar registros contenidos en una colección de datos, en base a un filtro determinado (/find)
Responses
Code
/find
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar\",\"customerData.campo2\": \"valor a buscar\"}" }
https://apirds2020.masterbase.com/findOne
Encontrar un registro que cumpla la o las condiciones de un filtro determinado (/findOne)
Responses
Code
/findOne
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar\",\"customerData.campo2\": \"valor a buscar\"}" }
https://apirds2020.masterbase.com/findOneAndUpdate
Encontrar y actualizar un registro que cumpla la o las condiciones de un filtro determinado (/findOneAndUpdate)
Responses
Code
/findOneAndUpdate
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.emailNormalizado\": \"contacto@dominio.com\"}", "update": "{\"$set\": {\"customerData.ApellidoM\": \"Roa\"}}", "options": "{\"returnOriginal\":false}" }
https://apirds2020.masterbase.com/updateOne
Actualizar un registro que cumpla la o las condiciones de un filtro determinado (/updateOne)
Responses
Code
/updateOne
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar\"}", "update": "{\"$set\": {\"customerData.campo1\": \"Nuevo valor\", \"customerData.campo2\": \"Nuevo valor\"}}" }
https://apirds2020.masterbase.com/updateMany
Actualizar todos los registros que cumplan la o las condiciones de un filtro determinado (/updateMany)
Responses
Code
/updateMany
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.emailNormalizado\": \"contacto@dominio.com\"}", "update": "{\"$set\": {\"customerData.comuna\": \"Nueva comuna\"}}" }
https://apirds2020.masterbase.com/insertOne
Ingresar un registro nuevo a la colección de datos (/insertOne)
Responses
Code
/insertOne/p>
Description
Succesfull response
Example Value | Model
{ "document": "{\"customerData\": { \"campo1\": \"valor a ingresar\", \"campo2\": \"valor a ingresar\"}}" }
https://apirds2020.masterbase.com/deleteOne
Eliminar un registro de la colección de datos, en base a un filtro determinado (/deleteOne)
Responses
Code
/deleteOne
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar para eliminar\", \"customerData.campo2\": \"valor a buscar para eliminar\"}" }
https://apirds2020.masterbase.com/deleteMany
Eliminar todos los registros de una colección de datos que cumplan la o las condiciones de un filtro determinado (/deleteMany)
Responses
Code
/deleteMany
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar para eliminar\", \"customerData.campo2\": \"valor a buscar para eliminar\"}" }
https://apirds2020.masterbase.com/count
Contar los registros que cumplan la o las condiciones de un filtro determinado (/count)
Responses
Code
/count
Description
Succesfull response
Example Value | Model
{ "filter": "{\"customerData.campo1\": \"valor a buscar\",\"customerData.campo2\": \"valor a buscar\"}" }