Rapid API용 Java SDK 설정

소프트웨어 개발 키트를 사용하면 간단히 통합할 수 있어 제품을 신속하게 시장에 출시할 수 있습니다.

개발 환경에는 Java 8 이상이 필요합니다. Apache Maven 또는 Gradle을 사용하여 프로젝트에 대한 SDK 종속성을 구성할 수 있습니다.

참고

Maven Central에서 최신 버전을 확인하실 수 있습니다.

2. 서비스 클라이언트 생성 및 구성

Rapid 엔드포인트에 요청을 보내려면 서비스 클라이언트를 생성하고 로그인 정보를 사용하여 구성합니다.

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

(선택 사항) 2.1. 제한 시간 구성

서비스 클라이언트는 요청, 연결 및 소켓에 대해 서로 다른 제한 시간을 구성할 수 있습니다.

2.1.1. 요청 제한 시간 구성

요청 제한 시간은 요청 시작부터 응답 완료까지 걸리는 시간입니다. 기본값은 무한대(제한 시간 없음)입니다.

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

2.1.2. 연결 제한 시간 구성

연결 제한 시간은 요청 시작부터 서버와의 연결이 설정될 때까지의 기간입니다. 기본값은 10000밀리초(10초)입니다.

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

2.1.3. 소켓 제한 시간 구성

소켓 제한 시간은 서버와 데이터를 교환할 때 두 개의 연속된 데이터 패킷 사이의 최대 비활성 기간입니다. 기본값은 15000밀리초(15초)입니다.

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

(선택 사항) 2.2. 엔드포인트 구성

Rapid API 엔드포인트를 재정의(예: 테스트 환경 사용)하도록 서비스 클라이언트를 구성할 수도 있습니다.

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

(선택 사항) 2.3. OkHttp 클라이언트 구성

서비스 클라이언트는 사용자 정의 OkHttpClient 인스턴스로 구성할 수 있습니다. 이를 통해 HTTP 클라이언트를 fine-tune 로 설정하여 연결 풀링, 타임아웃, 동시성 처리 등과 같은 기능을 통해 성능을 향상시킬 수 있습니다.

2.3.1. OkHttpClient 인스턴스 생성 및 구성

사용자 지정 구성으로 OkHttpClient 인스턴스를 생성합니다:

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

OkHttpClient구성에 대한 자세한 내용은 다음을 참조하십시오. OkHttp 문서.

2.3.2. OkHttpClient 인스턴스를 RapidClient 빌더에 전달합니다.

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

3. API 호출

서비스 클라이언트에는 Rapid API의 각 엔드포인트에 대한 메서드가 있습니다. 필수 매개변수로 해당 메서드를 호출하여 엔드포인트에 액세스할 수 있습니다.

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

비동기 실행

서비스 클라이언트는 각 엔드포인트에 대해 비동기 메서드도 제공합니다. 필수 매개변수로 해당 비동기 메서드를 호출하여 엔드포인트에 액세스할 수 있습니다.

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

자세한 정보를 확인하거나 API 호출에 대해 더 깊이 이해하려면 다음 참고 자료를 확인해 보세요: