Spring Boot Starter

es.neivi:iqx-lookup-spring-boot-starter — auto-configura un bean IqxLookup para aplicaciones Spring Boot 3.x.

Instalación

Maven:

<dependency>
    <groupId>es.neivi</groupId>
    <artifactId>iqx-lookup-spring-boot-starter</artifactId>
    <version>0.2.1</version>
</dependency>

Gradle:

implementation 'es.neivi:iqx-lookup-spring-boot-starter:0.2.1'

Configuración

application.yml:

iqx-lookup:
  api-key: ALk-your-api-key
  base-url: https://api.iqxlookup.neivi.es  # opcional
  timeout: 10                                # segundos, opcional

application.properties:

iqx-lookup.api-key=ALk-your-api-key
iqx-lookup.base-url=https://api.iqxlookup.neivi.es
iqx-lookup.timeout=10

Uso

El starter registra automáticamente un bean IqxLookup cuando iqx-lookup.api-key está configurado. Inyéctalo en cualquier lugar:

import es.neivi.iqx.lookup.IqxLookup;
import org.springframework.stereotype.Service;

@Service
public class ValidationService {

    private final IqxLookup lookup;

    public ValidationService(IqxLookup lookup) {
        this.lookup = lookup;
    }

    public boolean isEmailValid(String email) {
        return lookup.validateEmail(email).isValidFormat();
    }
}

Sobreescritura del Bean Personalizado

La auto-configuración usa @ConditionalOnMissingBean, por lo que puedes proporcionar tu propio bean IqxLookup:

@Configuration
public class CustomLookupConfig {

    @Bean
    public IqxLookup iqxLookup() {
        return IqxLookup.builder()
                .apiKey("custom-key")
                .timeout(Duration.ofSeconds(30))
                .buildClient();
    }
}

Referencia de Propiedades

Propiedad	Tipo	Valor por defecto	Descripción
iqx-lookup.api-key	String	—	Clave API (obligatoria, activa la auto-configuración)
iqx-lookup.base-url	String	https://api.iqxlookup.neivi.es	URL base
iqx-lookup.timeout	int	10	Timeout de petición en segundos

Consulta la página del SDK de Java para la referencia completa de la API y el manejo de errores.