링크 소개

링크란 무엇인가요?

RapidAPI는 여행객을 위한 통합 예약 경험을 구축할 수 있는 여러 API 리소스로 구성되어 있습니다. 따라서 이러한 리소스를 순차적으로 사용하여 조회, 요금 확인, 예약 예약 관리와 같은 완전한 거래를 구축할 수 있습니다.

이러한 다단계 거래를 간소화하기 위해 RapidAPI는 Link라는 강력한 도구를 사용합니다.

Link는 관련 리소스에 대한 참조로, 개발자가 거래를 원활하게 진행하는 데 필요한 다음 관련 API 리소스로 안내하는 가이드 역할을 합니다.

Rapid SDK 내에서 이전 작업의 링크를 활용함으로써 개발자는 일반적인 설정 프로세스를 우회하고 효율성을 크게 향상시켜 새로운 작업을 신속하게 생성하고 실행할 수 있습니다.

Information

참고

이 기능은 rapid-sdk v4.3.0 이상에서 사용할 수 있습니다.

링크를 사용하는 이유는 무엇인가요?

Link는 다음 작업을 수동으로 생성하지 않고도 Rapid API 작업을 탐색할 수 있는 편리한 방법입니다. 이전 작업의 응답에서 Link를 추출하고 이를 사용하여 다음 작업을 생성할 수 있습니다.

링크는 다음과 같은 혜택을 제공합니다.

  • 시간 절약: 요청 매개변수와 작업을 설정하여 다음 작업을 수동으로 생성할 필요가 없습니다.
  • 프로세스 간소화: 필요한 정보를 수동으로 추출할 필요 없이 이전 작업의 Link를 사용하여 Rapid API 작업을 쉽게 탐색할 수 있습니다.
  • 오류 감소: Link를 사용하면 다음 작업을 수동으로 생성할 때 발생할 수 있는 오류를 방지할 수 있습니다.

링크를 사용하는 방법은 무엇인가요?

Link를 얻으려면 이전 Operation 응답에서 추출해야 합니다. 그런 후 Link에서 다음 Operation을 생성하고 RapidClient를 사용하여 실행할 수 있습니다.

예를 들어 GetAvailabilityOperation의 응답에서 Link를 생성하고 이를 PriceCheckOperation 생성에 사용할 수 있습니다.

// 1. Create and execute the GetAvailabilityOperation (The first operation)
GetAvailabilityOperation getAvailabilityOperation = new GetAvailabilityOperation(getAvailabilityOperationParams);
Response<List<Property>> propertiesResponse = rapidClient.execute(getAvailabilityOperation);

// 2a. Select the needed property from the response (Here, we select the first property)
Property property = propertiesResponse.getData().get(0);

// 2b. Make sure the property is an instance of PropertyAvailability
if (!(property instanceof PropertyAvailability)) {
    return;
}

PropertyAvailability propertyAvailability = (PropertyAvailability) property;

// 3a. Extract the priceCheck link from PropertyAvailability operation (Here, we select the first rate for the first room, then get the priceCheck link)
Link priceCheckLink = propertyAvailability.getRooms().get(0).getRates().get(0).getBedGroups().entrySet().stream().findFirst().get().getValue().getLinks().getPriceCheck();

// 3b. Create the needed context for the PriceCheckOperation
PriceCheckOperationContext priceCheckOperationContext = PriceCheckOperationContext.builder().customerIp("1.2.3.4").build(); // fill the context as needed

// 4. Create and execute the PriceCheckOperation using the Link
PriceCheckOperation priceCheckOperation = new PriceCheckOperation(priceCheckLink, priceCheckOperationContext);
Response<RoomPriceCheck> roomPriceCheckResponse = rapidClient.execute(priceCheckOperation);
// ...

또 다른 예는 PriceCheckOperation의 응답에서 Link를 생성하고 이를 예약 생성에 사용할 수 있습니다.

// 1. Get the RoomPriceCheck from the previous step
RoomPriceCheck roomPriceCheck = roomPriceCheckResponse.getData(); // from the previous step

// 2a. Extract the Link from the RoomPriceCheck
Link postItineraryLink = roomPriceCheck.getLinks().getBook();

// 2b. Create the needed context for the PostItineraryOperation
PostItineraryOperationContext postItineraryOperationContext = PostItineraryOperationContext.builder().customerIp("1.2.3.4").build(); // fill the context as needed

// 2c. Create the CreateItineraryRequest
CreateItineraryRequest createItineraryRequest = CreateItineraryRequest.builder().build(); // fill the request as needed

// 3. Create and execute the PostItineraryOperation using the Link
PostItineraryOperation postItineraryOperation = new PostItineraryOperation(postItineraryLink, postItineraryOperationContext, createItineraryRequest);

// 4. Execute the PostItineraryOperation
Response<ItineraryCreation> itineraryCreationResponse = rapidClient.execute(postItineraryOperation);
ItineraryCreation itineraryCreation = itineraryCreationResponse.getData();

Link 사용 방법에 대한 추가 예는 사용 예 섹션을 참조해 주세요.

이 페이지가 도움이 되었나요?
이 콘텐츠를 어떻게 개선하면 좋을까요?
더 나은 만드는 데 도움을 주셔서 감사합니다!