Este servicio permite el envío de correos electrónicos. Actualmente soporta los siguientes servidores de correo:

• Ionos
• Gmail*
• Outlook

*Requiere generación de clave de aplicaciones

• Servidor Wildlfy 20 o superior
• Java 11 o OpenJDK 11
• S.O. Linux
• Ram 4GB o superior
• Disco Duro 64 GB
• Publicar la URL y Puerto del WildFly

• Debe contar con VPN
• Ejemplo de Consumo QA - Index: http://srv-appeon-000-w23.adacsc.co/AdaEmailService
• Ejemplo de consumo QA - Doc Swagger: http://srv-appeon-000-w23.adacsc.co/AdaEmailService/api-docs

{
  "smtpHost": "smtp.ionos.com",
  "smtpPort": 587,
  "smtpAuth": "true",
  "smtpMailUser": "email.test@ada.co",
  "smtpMailPassword": "password",
  "smtpStartTlsEnabled": false,
  "smtpSessionDebug": true,
  "subject": "Título de Prueba",
  "content": "Contenido de prueba",
  "html": false,  
  "toEmail": [
    {
      "address": "notififacionTo.test@ada.co",
      "persona": "Notificación To"
    }
  ],
  "ccEmail": [
    {
      "address": "notififacionCc.test@ada.co",
      "persona": "Notificación Cc"
    }
  ],
  "bccEmail": [
    {
      "address": "notififacionBcc.test@ada.co",
      "persona": "Notificación Bcc"
    }
  ]
}

{
  "smtpHost": "smtp.outlook.com",
  "smtpPort": 587,
  "smtpAuth": "true",
  "smtpMailUser": "correo",
  "smtpMailPassword": "password",
  "smtpStartTlsEnabled": true,
  "smtpSessionDebug": true,
  "subject": "Prueba",
  "content": "Ejemplo",
  "html": false,  
  "toEmail": [
    {
      "address": "correo",
      "persona": "persona"
    }
  ],
  "ccEmail": [
    {
      "address": "correo copia",
      "persona": "Persona Copia"
    }
  ],
  "bccEmail": [
    {
      "address": "Correo copia oculta",
      "persona": "Persona copia oculta"
    }
  ]
}

{
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 587,
  "smtpAuth": "true",
  "smtpMailUser": "correo",
  "smtpMailPassword": "clave aplicacion",
  "smtpStartTlsEnabled": true,
  "smtpSessionDebug": true,
  "subject": "Prueba",
  "content": "Ejemplo",
  "html": false,  
  "toEmail": [
    {
      "address": "Correo",
      "persona": "Persona"
    }
  ],
  "ccEmail": [
    {
      "address": "Correo copia",
      "persona": "Persona copia"
    }
  ],
  "bccEmail": [
    {
      "address": "Correo copia oculta",
      "persona": "Persona copia oculta"
    }
  ]
}

Se libera versión con soporte de envios masivos sin necesidad de servidor SMTP.

Se libera la documentación técnica javadoc la cual puede ser consultada desde la carpeta de documentación del proyecto en la ruta del SVN

Debe descargar el proyecto para visualizar la documentación.

Se libera documentación OpenAPI V3 la cual se comparte a continuación y puede se utiliza en el visor swagger

{"openapi":"3.0.1","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost:8088","description":"Generated server url"}],"tags":[{"name":"EmailController","description":"Controlador que gestiona los envíos de correos electrónicos en las aplicaciones."}],"paths":{"/email/v2/sendMasive":{"post":{"tags":["EmailController"],"summary":"sendMasive","description":"Envía correos electrónicos de forma masiva.","operationId":"sendMasive","parameters":[{"name":"token","in":"header","description":"Token API utilizado para realiza el envío. Si no se especifica se utiliza uno genérico.","required":false,"schema":{"type":"string"},"example":"eyFDSFDSF4%$#%$#%VFDvcxvkxkvljxkljelkrjklcjvklcxjvklxjv"},{"name":"emailDto","in":"query","description":"Objeto con la configuración del envio y contenido del correo electrónico que será enviado","required":true,"schema":{"$ref":"#/components/schemas/EmailDto"}}],"responses":{"500":{"description":"Se han generado inconsistencias al crear el registro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}},"202":{"description":"Correo electrónico enviado correctamente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}},"503":{"description":"No se puede enviar el correo electrónico.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}}}}},"/email/v1/send":{"post":{"tags":["EmailController"],"summary":"send","description":"Envía correos electrónicos.","operationId":"send","parameters":[{"name":"emailConfigDto","in":"query","description":"Objeto con la configuración del envio y contenido del correo electrónico que será enviado","required":true,"schema":{"$ref":"#/components/schemas/EmailConfigDto"},"example":{"smtpHost":"smtp.ionos.com","smtpPort":587,"smtpAuth":"true","smtpMailUser":"email.test@ada.co","smtpMailPassword":"password","smtpStartTlsEnabled":false,"smtpSessionDebug":true,"subject":"Título de Prueba","content":"Contenido de prueba","html":false,"toEmail":[{"address":"notififacionTo.test@ada.co","persona":"Notificación To"}],"ccEmail":[{"address":"notififacionCc.test@ada.co","persona":"Notificación Cc"}],"bccEmail":[{"address":"notififacionBcc.test@ada.co","persona":"Notificación Bcc"}]}}],"responses":{"500":{"description":"Se han generado inconsistencias al crear el registro.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}},"202":{"description":"Correo electrónico enviado correctamente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}},"503":{"description":"No se puede enviar el correo electrónico.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericResponseDto"}}}}},"deprecated":true}},"/email/":{"get":{"tags":["EmailController"],"summary":"index","description":"Método de validación de estado del microservicio","operationId":"index","responses":{"200":{"description":"Microsericio en linea","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailController"}}}}}}}},"components":{"schemas":{"AddressConfigDto":{"type":"object","properties":{"address":{"type":"string"},"persona":{"type":"string"}},"description":"Clase Dto que contiene la configuración de la dirección de correo electronico."},"AttachmentConfigDto":{"type":"object","properties":{"fileName":{"type":"string"},"fileContentStringBase64":{"type":"string"},"typeContent":{"type":"string"}},"description":"Clase Dto que contiene la configuración del archivo que se adjuntará al correo electrónico."},"EmailDto":{"type":"object","properties":{"from":{"$ref":"#/components/schemas/AddressConfigDto"},"subject":{"type":"string"},"content":{"type":"string"},"html":{"type":"boolean"},"attachmentBase64":{"type":"array","items":{"$ref":"#/components/schemas/AttachmentConfigDto"}},"toEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}},"ccEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}},"bccEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}}},"description":"Clase Dto que contiene la configuración e información del correo electrónico."},"GenericResponseDto":{"type":"object","properties":{"code":{"type":"integer","format":"int64"},"message":{"type":"string"},"content":{"type":"object"}},"description":"Dto generico utilizado para respuestas en servicios."},"EmailConfigDto":{"type":"object","properties":{"smtpHost":{"type":"string"},"smtpPort":{"type":"string"},"smtpAuth":{"type":"string"},"smtpMailUser":{"type":"string"},"smtpMailPassword":{"type":"string"},"smtpStartTlsEnabled":{"type":"string"},"smtpSslTrust":{"type":"string"},"smtpSessionDebug":{"type":"boolean"},"subject":{"type":"string"},"content":{"type":"string"},"html":{"type":"boolean"},"attachmentBase64":{"type":"array","items":{"$ref":"#/components/schemas/AttachmentConfigDto"}},"toEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}},"ccEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}},"bccEmail":{"type":"array","items":{"$ref":"#/components/schemas/AddressConfigDto"}}},"description":"Clase Dto que contiene las configuraciones de autenticación y envío del correo electrónico."},"EmailController":{"type":"object"}}}}

←Volver atrás