Java SDK

Contamos con una librería para facilitar el uso de la API desde Java.

SERVICIO DISCONTINUADO

La API de envíos transaccionales ya no está disponible para nuevas suscripciones.

Para las suscripciones activas, el servicio será discontinuado en su totalidad el día 1/3/2026.

Instalación

Las formas más comunes de incluir la SDK en los proyectos es utilizando Maven o Gradle.

Maven

<dependency>
    <groupId>com.myperfit.sdk.transactional</groupId>
    <artifactId>transactionalsdk</artifactId>
    <version>[1.0,2.0)</version>
</dependency>

Gradle

compile group: 'com.myperfit.sdk.transactional', name: 'transactionalsdk', version: '1.+'

Uso básico

PerfitTransactional perfit = PerfitTransactional.builder()
        .apiKey("API_KEY")
        .build();

// Remitente
MailAddressRequest fromAddress = MailAddressRequest.builder()
        .email("[e-mail]")
        .name("Nombre Remitente")
        .build();

// Contenidos
MailContentRequest content = MailContentRequest.builder()
        .html("<h1>contenido html</h1>")
        .text("contenido texto plan")
        .build();

// Listado de destinatarios
List<MailRecipientRequest> recipients = new ArrayList<>();

MailAddressRequest toAddress1 = MailAddressRequest.builder()
        .email("[e-mail]")
        .name("Nombre Destinatario") 
        .build();
        
MailRecipientRequest recipient1 = MailRecipientRequest.builder()
        .to(toAddress1)
        .substitutions(Map.of("first_name","Nombre", "last_name", "Apellido"))
        .customArgs(Map.of("my_tracking_id","value1", "other_id", "value2"))
        .build();
        
recipients.add(recipient1);

// Mensaje completo
SendMailRequest request = SendMailRequest.builder()
        .from(fromAddress)
        .subject("Test Subject")
        .content(content)
        .recipients(recipients)
        .tags(List.of("tag1", "tag2"))
        .build();

try {
        // Envío del email
        perfit.send(request);
} catch (RequestFailedException ex) {
        // Manejar excepciones
}