XAP SDK 설정하기

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

1. Java 개발 환경 설정

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

2. 서비스 클라이언트 생성 및 로그인 정보 구성

모든 API 요청은 API 클라이언트 ID와 암호를 사용하여 인증되어야 합니다. XapClient를 생성하고 이를 로그인 정보로 구성합니다.

XapClient xapClient =
    XapClient
        .builder()
        .key("KEY")
        .secret("SECRET")
        .build();

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

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

2.1.1. 요청 제한 시간 구성

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

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

2.1.2. 연결 제한 시간 구성

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

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

2.1.3. 소켓 제한 시간 구성

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

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

3. 요청 처리 로직을 구축하고 API 호출을 수행합니다.

SDK에 정의된 클래스를 사용하여 요청 개체를 빌드하고 이를 사용해 API 호출을 수행하려면 서비스 클라이언트를 사용합니다.

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

GetLodgingListingsOperation getLodgingListingsOperation =
        new GetLodgingListingsOperation(getLodgingListingsOperationParams);

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

추가 정보가 필요한 경우 사용 예를 확인해 주세요. API 호출에 대한 더 나은 분석 정보를 얻으려면 로깅을 구성해 보세요.