Configuração do SDK do Java para a Rapid API

Os kits de desenvolvimento de software simplificam a integração para que você coloque os produtos no mercado com rapidez

Inicie a parceria e receba as suas credenciais

Para mais informações, consulte Introdução à Rapid API.

1. Configurar o ambiente de desenvolvimento Java

O ambiente de desenvolvimento precisa ter Java 8 ou uma versão posterior. Você pode usar o Apache Maven ou o Gradle para configurar as dependências do SDK para os seus projetos.

Observação

Você pode encontrar a versão mais recente no Maven Central.

2. Criar e configurar um cliente de serviço

Para fazer solicitações aos pontos de extremidade da Rapid, crie e configure um cliente de serviço com as suas credenciais.

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

(Opcional) 2.1. Configurar o tempo limite

O cliente de serviço pode ser configurado com diferentes tempos limite de solicitação, conexão e soquete.

2.1.1. Configurar tempo limite de solicitação

O tempo limite de solicitação é o período desde o início da solicitação até a conclusão da resposta. O valor padrão é infinito (sem tempo limite).

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

2.1.2. Configurar tempo limite de conexão

O tempo limite de conexão é o período desde o início da solicitação até o estabelecimento da conexão com o servidor. O valor padrão é 10.000 milissegundos (10 segundos).

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

2.1.3. Configurar tempo limite de soquete

O tempo limite de soquete é o período máximo de inatividade entre dois pacotes de dados consecutivos ao trocar dados com um servidor. O valor padrão é 15.000 milissegundos (15 segundos).

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

(Opcional) 2.2. Configurar ponto de extremidade

Também é possível configurar o cliente de serviço para substituir o ponto de extremidade da Rapid API, um exemplo seria para usar o ambiente de testes.

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

(Opcional) 2.3. Configurar o cliente OkHttp

O cliente de serviço pode ser configurado com uma instância OkHttpClientpersonalizada. Isso permite que você fine-tune o cliente HTTP Para melhor desempenho, como pool de conexões, tempos limite e tratamento de simultaneidade.

2.3.1. Crie e configure uma instância OkHttpClient

Crie uma instância de OkHttpClientcom suas configurações personalizadas:

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

Para obter mais informações sobre como configurar o OkHttpClient, consulte a documentação do OkHttp.

2.3.2. Passe a instância OkHttpClient para o construtor RapidClient

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

3. Fazer chamadas da API

O cliente de serviço tem um método para cada ponto de extremidade na Rapid API. Para acessar o ponto de extremidade, use o método correspondente com os parâmetros necessários para fazer a chamada.

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());

Execução assíncrona

O cliente de serviço também oferece métodos assíncronos para cada ponto de extremidade. Para acessar o ponto de extremidade, use o método assíncrono correspondente com os parâmetros necessários para fazer a chamada.

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()));

Precisa de mais informações? Confira os nossos exemplos de uso. Para consultar insights aprimorados sobre as chamadas de API, configure o registro.