Configurando o SDK XAP

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

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.

2. Criar um cliente de serviço e configurar as credenciais

Todas as solicitações da API devem ser autenticadas usando o ID e segredo de cliente da API. Crie um XapClient e faça a configuração com as suas credenciais.

XapClient xapClient =
    XapClient
        .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).

XapClient xapClient=
    XapClient
        .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).

XapClient xapClient=
    XapClient
        .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).

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

3. Criar operação de requisição e fazer chamadas de API

Crie o seu objeto de solicitação usando as classes definidas no SDK e faça a chamada da API com o cliente de serviço usando esse objeto.

GetLodgingListingsOperationParams getLodgingListingsOperationParams
        = GetLodgingListingsOperationParams
            .builder()
            .partnerTransactionId("PARTNER TRANSACTION ID")
            .locationKeyword("LOCATION KEYWORD")
            .build();

GetLodgingListingsOperation getLodgingListingsOperation =
        new GetLodgingListingsOperation(getLodgingListingsOperationParams);

Response<HotelListingsResponse> hotelListingsResponse =
        client.execute(getLodgingListingsOperation);

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