Configurar el SDK para Java de Rapid API

Los kits de desarrollo de software simplifican la integración para que puedas comercializar productos rápidamente

Colaborar con nosotros y obtener tus credenciales

Si deseas obtener más información, consulta Primeros pasos con Rapid.

1. Configura un entorno de desarrollo de Java.

El entorno de desarrollo debe incluir Java 8 o una versión posterior. Puedes usar Apache Maven o Gradle para configurar dependencias de SDK en tus proyectos.

Nota

Puedes encontrar la última versión en Maven Central.

2. Crea un cliente de servicio y configúralo.

Para presentar solicitudes a los puntos de conexión de Rapid, crea un cliente de servicio y configúralo con tus credenciales.

RapidClient rapidClient =
    RapidClient
        .builder()
        .key("KEY")
        .secret("SECRET")
        .build();

(Opcional) 2.1. Configura el tiempo de espera.

El cliente de servicio puede configurarse con diferentes tiempos de espera para la solicitud, la conexión y el socket.

2.1.1. Configura el tiempo de espera de la solicitud.

El tiempo de espera de la solicitudes el periodo de tiempo que transcurre desde que se inicia hasta que se completa la respuesta. El valor predeterminado es infinito (no hay tiempo de espera).

RapidClient rapidClient=
    RapidClient
        .builder()
        .requestTimeout(90_000) // 90 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

2.1.2. Configura el tiempo de espera de la conexión.

El tiempo de espera de la conexión es el periodo de tiempo que transcurre desde que se inicia hasta que se establece la conexión con el servidor. El valor predeterminado es 10 000 milisegundos (10 segundos).

RapidClient rapidClient=
    RapidClient
        .builder()
        .connectionTimeout(30_000) // 30 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

2.1.3. Configura el tiempo de espera del socket.

El tiempo de espera del socket es el periodo máximo de inactividad entre dos paquetes de datos consecutivos al intercambiar datos con un servidor. El valor predeterminado es 15 000 milisegundos (15 segundos).

RapidClient rapidClient=
    RapidClient
        .builder()
        .socketTimeout(30_000) // 30 seconds
        .key("KEY")
        .secret("SECRET")
        .build();

(Opcional) 2.2. Configura un punto de conexión.

También es posible configurar el cliente de servicio para anular el punto de conexión de Rapid API (para usar el entorno de pruebas, por ejemplo).

RapidClient rapidClient =
    RapidClient
        .builder()
        .endpoint("https://test.ean.com/v3/")
        .key("KEY")
        .secret("SECRET")
        .build();

(Opcional) 2.3. Configura OkHttp cliente

El cliente de servicio puede configurarse con una instancia personalizada deOkHttpClient. Esto te permite fine-tune el cliente HTTP Para mejorar el rendimiento, como la agrupación de conexiones, los tiempos de espera y la gestión de la concurrencia.

2.3.1. Crear y configurar una instancia OkHttpClient

Crea una instancia de OkHttpClientcon tus configuraciones personalizadas:

OkHttpClient customClient = new OkHttpClient.Builder()
        .connectTimeout(30, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.SECONDS)
        .writeTimeout(30, TimeUnit.SECONDS)
        .build();

Para más información sobre la configuración de OkHttpClient, consulta la documentación de OkHttp.

2.3.2. Pasa la instancia OkHttpClient al constructor RapidClient

RapidClient rapidClient = RapidClient.builderWithHttpClient()
        .okHttpClient(customClient)
        .key("YOUR_API_KEY")
        .secret("YOUR_API_SECRET")
        .build();

3. Realiza llamadas a la API.

El cliente de servicio tiene un método para cada punto de conexión en Rapid API. Para acceder al punto de conexión, usa el método correspondiente y los parámetros necesarios para efectuar la llamada.

GetAvailabilityOperationParams getAvailabilityOperationParams = GetAvailabilityOperationParams.builder()
        .checkin("YYYY-MM-DD")
        .checkout("YYYY-MM-DD")
        .currency("USD")
        .language("en_US")
        /* ... */
        .build();
GetAvailabilityOperation getAvailabilityOperation = new GetAvailabilityOperation(getAvailabilityOperationParams);
Response<List<Property>> propertiesResponse = rapidClient.execute(getAvailabilityOperation);
System.out.println(propertiesResponse.getData());

Ejecución asíncrona

El cliente de servicio también ofrece métodos asíncronos para cada punto de conexión. Para acceder al punto de conexión, usa el método asíncrono correspondiente y los parámetros necesarios para efectuar la llamada.

GetAvailabilityOperationParams getAvailabilityOperationParams = GetAvailabilityOperationParams.builder()
        .checkin("YYYY-MM-DD")
        .checkout("YYYY-MM-DD")
        .currency("USD")
        .language("en_US")
        /* ... */
        .build();
        
GetAvailabilityOperation getAvailabilityOperation = new GetAvailabilityOperation(getAvailabilityOperationParams);

/*  
    The executeAsync method is used to perform an asynchronous operation with the rapidClient, 
    allowing the application to continue executing other tasks while waiting for the operation to complete.
 */
CompleteableFuture getAvailability = rapidClient.executeAsync(getAvailabilityOperation)
        .thenAccept(response -> System.out.println(response.getData()));

¿Necesitas más información? Consulta nuestros ejemplos de uso. Para conocer mejor tus llamadas a la API, configura el registro.