변경 로그

다음은 출시 월별로 정리된 Rapid API의 모든 변경 목록입니다.

|

2024년 4월

로열티 - Book | Shop | Feature | V3

숙박 시설 로열티 포인트 적립 기회를 제공하는 비즈니스 요금을 찾을 수 있는 새로운 기능을 추가하고 있습니다. 호텔 로열티 포인트에 대해 자세히 알아보세요.

장점:

파트너는 출장 여행객이 숙박 시설 로열티 프로그램에서 포인트를 쉽게 적립하도록 돕는 더 나은 도구를 갖게 됩니다.


2024년 1월

마케팅 수수료 인센티브 - Shop | Feature | V3

include 매개변수에 대한 조회 요청에 새 값을 추가했습니다. 이로 인해 응답에서 marketing_fee_incentives 개체가 반환됩니다.

Rapid 3 요청 예시:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 응답 예시:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "marketing_fee_incentives": [
              {
                "source": "property",
                "start": "2024-01-01",
                "end": "2024-01-01"
              }
            ],
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

장점:

파트너는 특별 인센티브가 적용된 요금을 더 쉽게 확인할 수 있습니다.


2023년 11월

새 검색 및 필터 옵션 - Content | Feature | V3

다음 필드를 기준으로 검색 결과의 범위를 좁힐 수 있는 새 요청 매개변수를 추가했습니다.

  • all_inclusive
  • amenity_id
  • attribute_id
  • category_id
  • spoken_language_id

또한 include 매개변수에 대한 유효한 값의 수를 늘려 응답의 어떤 부분을 포함시킬 것인지를 훨씬 더 세분화하여 지정할 수 있도록 했습니다. 새 값에는 콘텐츠 응답의 모든 최상위 요소가 포함됩니다. 자세한 내용은 검색 및 필터링 참조하세요.

Rapid 3 요청 예시: 이 예에서는 새 amenity_id 검색 매개변수를 사용하고, include 매개변수에 새 값인 nameamenities 사용하고 있습니다.

curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=name\
&include=amenities\
&property_id=1337\
&property_id=1" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 응답 예시: 이 응답에서는 숙박 시설 1에 이용 가능한 편의 시설 ID 115가 없어서 숙박 시설 1337만 반환되는 것을 확인할 수 있습니다. 또한 property_id, name, amenities가 응답에 포함되어 있는 것을 확인할 수 있습니다. property_id 항상 응답에 포함되며, 응답에서 원하는 유일한 필드가 아닌 한 include 요청 매개변수로 지정할 필요가 없습니다.

{
  "1337": {
    "property_id": "1337",
    "name": "Hyatt Regency Paris Etoile",
    "amenities": {
      "8": {
        "id": "8",
        "name": "Elevator"
      },
      "43": {
        "id": "43",
        "name": "Concierge services"
      },
      "115": {
        "id": "115",
        "name": "Bicycle rentals nearby"
      },
      "361": {
        "id": "361",
        "name": "Breakfast available (surcharge)"
      },
      ...
    }
  }
}

장점:

보다 구체적인 숙박 시설과 보다 구체적인 응답 필드를 원하는 파트너는 이제 Rapid 콘텐츠 API와의 상호 작용을 최적화할 수 있습니다. 어떤 콘텐츠가 필요한지 지정함으로써 파트너는 어떤 콘텐츠가 사용되어 파트너에게 가치가 있는지 Rapid 팀에도 알릴 수 있습니다.


모바일 프로모션 세일 시나리오 - Shop | Feature | V3

변경 요청에 대한 예약 가능 여부 및 쇼핑을 위한 include 매개변수에 sale_scenario.mobile_promotion 값을 추가했습니다.

변경 응답에 대한 예약 가능 여부, 추가 요금 및 쇼핑에 room.rate.sale_scenario.mobile_promotion 필드를 추가했습니다.

Rapid 3 요청 예시:

curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
&currency=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=mobile_app\
&sales_environment=hotel_only\
&include=sale_scenario.mobile_promotion\
&travel_purpose=leisure" \
 -H "accept: application/json, application/json"\
 -H "accept-encoding: gzip"\
 -H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
 -H "user-agent: TravelNow/3.30.112"

Rapid 3 응답 예시:

[
  {
    "property_id": "19248",
    "status": "available",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            "status": "available",
            ...
            "sale_scenario": {
              "package": false,
              "member": false,
              "corporate": false,
              "distribution": false,
              "mobile_promotion": false
            },
            ...
          }
        ]
      }
    ],
    "links": { ... },
    "score": 10052
  }
]

장점:

모바일 프로모션 특가 상품에 어떤 요금이 연결되어 있는지 더 쉽게 식별하고자 하는 파트너에게는 이를 달성하기 위한 새로운 방법이 있습니다.


새 버스 정류장 지역 유형 - Geography | Feature | V3

지역 엔드포인트에 대한 요청에 bus_station 지역 유형을 추가했습니다. 이제 단일 지역과 복수 지역 모두 bus_station 유형의 지역에 대한 데이터를 제공합니다.

Rapid 3 요청 예시:

curl -X GET "https://test.ean.com/v3/regions\
?include=standard\
&language=en-US\
&supply_source=expedia\
&type=bus_station" \
 -H "Accept: application/json" \
 -H "Authorization: EAN apikey=1234,signature=14140287ea6ea1396b18b,timestamp=1697826383" \
 -H "Accept: application/json" \
 -H "Accept-Encoding: gzip" \
 -H "User-Agent: TravelNow/3.30.112"

Rapid 3 응답 예시:

[
  {
    "id": "11234754",
    "type": "bus_station",
    "name": "Port Authority Bus Terminal",
    "name_full": "Port Authority Bus Terminal",
    "country_code": "US"
  }
]

장점:

파트너는 여행객을 위해 사이트에 버스 정류장 정보를 포함할 수 있습니다.


2023년 10월

콘텐츠에 휴가용 주택 IPM 이름 추가 - Content | Feature | V3

숙박 시설 콘텐츠 응답에 vacation_rental_details.ipm_name을 추가되었습니다.

Rapid 3 응답 예시:

{
  "4687248": {
    "property_id": "4687248",
    "name": "Beautiful 6 Bedroom Home With Two Pools, Only 10 minutes To Theme Park!",
    "address": { ... },
    ...
    "fees": {
      "traveler_service": "Your credit card statement will show two separate charges, one for the booking amount and property fees and another for the service fee. Both will be charged by Expedia partner Good Company.. The traveler service fee is refundable only when your entire booking is fully refundable. Please refer to the terms and conditions for the rules applicable to the booking facilitation services provided."
    },
    "attributes": { ... },
    ...
    "vacation_rental_details": {
      "private_host": true,
      ...
      "vrbo_srp_id": "334.3634257.3458973",
      "listing_id": "1252577",
      "listing_number": "3834275",
      "listing_source": "VRBO",
      "listing_unit": "/units/0001/429ecad2-bade-429a-a427-8adee57420ec",
      "ipm_name": "Good Company",
      "unit_configurations": { ... },
      "enhanced_house_rules": { ... },
      "free_text": "Stunning brand new 2-story home with 6 bedrooms, 4 bathrooms, brand new appliances/furniture, game room, grill, patio, and beautiful scenery all around. Minutes from Super Cool Lake. This place is the perfect getaway for a larger group whether it be a golf trip, lake trip, or time to gather with the family. Please note this property has two parking stalls, in addition to first come first serve overflow parking in the community. Celebrating something special? Birthday, Anniversary, Bachelor/Bachelorette, etc? We also offer decorating services for an extra fee. Please inquire within! This home features a fully-equipped kitchen for preparing meals, onsite washer and dryer and most importantly a private space, much larger than a hotel room for private family time away from crowds and people. We have a self-check-in and check-out system to limit your contact with people as well. THE BASICS: 6 bedrooms & 1 loft - 5 Kings, 2 Bunk beds , and 1 pull-out couch in the loft - Sleeps 16 people. 4 Bathrooms - Master (jetted tub, walk-in shower, double sinks), other 3 bathrooms (tub/shower combo & sink). Fully Equipped Kitchen. Open Main Room with plenty of seating. Dining Room table and bar stools around kitchen island area. Plenty of space to spread out and enjoy your friends/family. Free Wifi. THE EXPERIENCE IN DETAIL: -As you walk in the front door and are greeted by the open floor layout of our kitchen and great room you immediately breathe easy seeing that there is plenty of room here for you and your family. Our Kitchen is stocked with plenty of cookware and dishes so you can create a huge breakfast that will get everyone out of bed and ready for a day of fun. A potted coffee maker and a Keurig is available. You will need to bring your own coffee/pods/filters/creamer etc. Cozy up in the living room for a late night movie on our large flat-screen TV equipped for your viewing pleasure. Our luxury Master bedroom with it’s King size bed, premium bedding, and TV invite you and your spouse to relax together and feel a little spoiled. This is a vacation after all! Enjoy our Master Bath with it’s jetted tub, walk-in shower, and double sinks. Explore the Upstairs which has 4 Bedrooms - 3 furnished with a King size bed, premium bedding, 1 is the bunk room which is equipped with 4 twin size beds. This home is not handicapped accessible!!!"
    },
    "supply_source": "Vrbo",
    "spoken_languages": { ... }
  }
}

장점:

Vrbo 공급을 판매하는 파트너는 카드에 요금을 청구하거나 확인 이메일을 보낼 IPM의 이름을 안내하는 고객 메시지의 작성을 위해 IPM 이름이 필요합니다. 현재 이 정보는 단락 형식인 fees.traveler_service 콘텐츠의 일부로만 제공됩니다.


검색에 마케팅 수수료 추가 - Manage Booking | Feature | V3

검색 응답에 room.rate.pricing.totals.marketing_fee 검색 시 예상되는 값을 추가했습니다.

Rapid 3 응답 예시:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "rooms": [
    {
      "id": "926784314",
      "confirmation_id": { ... },
      ...
      "status": "booked",
      ...
      "rate": {
        "id": "035943984",
        "merchant_of_record": "expedia",
        ...
        "pricing": {
          "nightly": [ ... ],
          "stay": [ ... ],
          "totals": {
            "inclusive": { ... },
            "exclusive": { ... },
            "marketing_fee": {
              "billable_currency": {
                "value": "7.75",
                "currency": "USD"
              }
            },
            "property_fees": { ... }
          },
          "fees": { ... }
        }
      },
      "links": { ... }
    }
  ],
  "billing_contact": { ... },
  ...
}

장점:

예약에 중대한 변경이 적용된 후 파트너는 marketing_fee에 대해 업데이트된 값을 확인할 수 있습니다.

2023년 9월

검색에 여행 목적 추가 - Manage Booking | Feature | V3

검색 응답에 travel_purpose의 저장된 값이 추가되었습니다.

Rapid 3 응답 예시:

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  ...
  "conversations": {...}
  "travel_purpose": "leisure",
  "trader_information": {...}
}

장점:

파트너는 숙소에 전달된 여행객의 여행 목적 값이 출장 또는 휴가인지 검토할 수 있습니다.

2023년 7월

비활성 숙박 시설 - Content | Feature | V3

비활성 숙박 시설 엔드포인트를 추가했습니다.

Rapid 3 요청 예시:

https://test.ean.com/v3/properties/inactive?since=2023-07-12

Rapid 3 응답 예시:

[
  {
    "property_id": "15316"
  },
  {
    "property_id": "15362666"
  },
  {
    "property_id": "15462554"
  },
  {
    "property_id": "1614382"
  },
  {
    "property_id": "18762476"
  }
]

장점:

파트너는 캐시로 저장된 콘텐츠를 통해 숙박 시설을 쉽게 삭제하고 더 이상 예약 가능 여부 요청을 보내지 않는 숙박 시설을 확인할 수 있습니다.


여행 목적 지표 - Shop | Feature | V3

예약 가능 여부 요청에 travel_purpose 매개변수가 추가되었습니다.

Rapid 3 요청 예시:

예약 가능 여부 요청에 대한 새로운 매개변수:

travel_purpose=business

장점:

여행객의 여행 목적이 출장 또는 휴가인지 전달할 수 있습니다.


이용 불가 이유 - Shop | Feature | V3

요금이 반환되지 않고 구체적인 이유가 있는 숙박 시설 항목을 응답에 포함하도록 요청하기 위해 unavailable_reason 값이 있는 include 매개변수를 예약 가능 여부 요청에 추가했습니다.

Rapid 3 요청 예시:

예약 가능 여부 요청에 대한 새로운 매개변수:

include=unavailable_reason

장점:

조회 결과의 일부로 숙박 시설을 예약할 수 없는 이유를 포함할 수 있습니다.


편의 시설 범주 검색 - Shop | Feature | V3

예약 가능 여부 요청에 amenity_category 매개변수가 추가되었습니다.

Rapid 3 요청 예시:

예약 가능 여부 요청에 대한 새로운 매개변수:

amenity_category=wifi

장점:

동일한 범주의 편의 시설이 포함된 요금을 검색할 수 있습니다.


할인 전 가격 표시 포함 - Shop | Feature | V3

inclusive_strikethrough에 대한 가격 정보를 추가했습니다.

Rapid 3 응답 예시:

[
  {
    "property_id": "19248",
    "rooms": [
      {
        "id": "123abc",
        "room_name": "Fancy Queen Room",
        "rates": [
          {
            "id": "333abc",
            ...
            "occupancy_pricing": {
              "2": {
                "nightly": [ ... ],
                "stay": [ ... ],
                "totals": {
                  "inclusive": { ... },
                  "exclusive": { ... },
                  "inclusive_strikethrough": {
                    "billable_currency": {
                      "value": "726.63",
                      "currency": "CAD"
                    },
                    "request_currency": {
                      "value": "549.60",
                      "currency": "USD"
                    }
                  },
                  "strikethrough": { ... },
                  "marketing_fee": { ... },
                  "gross_profit": { ... },
                  "minimum_selling_price": { ... },
                  "property_fees": { ... }
                },
                "fees": { ... }
              }
            }
          }
        ]
      }
    ]
  }
]

장점:

호텔에서 부담하는 할인으로 인한 절감액을 홍보할 수 있습니다(세금 및 수수료 포함).

2023년 6월

중대한 변경 - Book | Feature | V3

새로운 중대한 변경 엔드포인트와 Rapid 흐름을 추가했습니다.

장점

이제 Rapid API를 통해 여행객을 대신하여 예약을 수정할 수 있습니다.

자세한 내용은 중대한 변경을 참조해 주세요.


일정 기록 - Book | Feature | V3

일정 검색 및 일정 확인 호출에 일정 기록 정보를 추가했습니다.

장점

이제 일정 검색 또는 일정 확인의 일부로 생성, 중대한 변경 및 취소와 관련된 일정 기록의 세부 정보를 검색할 수 있습니다.

자세한 내용은 일정 기록을 참조해 주세요.

2023년 4월

VRBO 호스트 자유 텍스트 설명 - Content | Feature | V3

숙박 시설 콘텐츠 응답의 vacation_rental_details 섹션에 free_text를 추가했습니다.

Rapid 3 스키마 예시:

{
  "12345": {
    "property_id": "12345",
    "name": "Test Property Name",
    "phone": "1-417-862-0153",
    "vacation_rental_details": {
      "free_text": "Free form description and explanation of property provided by the host.Can possibly contain html break tags.",
      "listing_id": "1237874"
    }
  }
}

참고: 콘텐츠 응답의 모든 숙박 시설이 예시에 표시된 것은 아닙니다.

장점

호스트가 제공한 휴가용 주택에 대한 자세한 정보를 파트너가 표시할 수 있습니다.

Vrbo on Rapid 통합 가이드를 참조해 주세요.


지역 검색 개선 사항 - Geography | Feature | V3

몇 가지 새로운 검색 매개변수가 추가되었습니다:

  • area 반경과 좌표(위도/경도 쌍) 또는 지역 ID를 사용하여 영역을 정의합니다.
  • limit 반환되는 결과 수를 제한합니다.
  • country_subdivision_code ISO 3166-2 국가 세분화 코드와 일치하는 결과를 반환합니다.

country_subdivision_codeRegions응답에 Region를 추가했습니다.

장점

파트너가 지정된 영역과 교차하는 지역을 선택할 수 있습니다.

위도/경도 50km 이내의 공항 검색:

type=airport&limit=3&area=50,37.227924,93.310036

OpenAPI 사양 개선 사항 - Update | V3

OpenAPI 사양이 여러 가지로 개선되었습니다:

  • API 탐색기에서 올바르게 표시되도록 날짜가 따옴표로 묶여 있습니다.
  • Java 클라이언트 생성 코드와의 호환성을 개선하기 위해 BoundingPolygon이 다시 조정되었습니다.
  • ISO 표준을 참조하여 일관성이 향상(예. ISO 639-1 alpha-2ISO 3166-1 alpha-2)되었습니다.

이 변경은 API 기능에 영향을 미치지 않으며, OpenAPI 사양을 개선합니다.

장점

API 탐색기의 기능이 향상되었고 다운로드한 OpenAPI 사양 yaml 파일을 사용하여 파트너의 호환성이 개선되었습니다.

2023년 1월

환불 가능 파손 보증금 요금 제외 - Shop | Feature | V3

예약 가능 여부 요청에 exclusion 매개변수가 추가되었습니다.

Rapid 3 요청 예시:

Shop 요청에 대한 새로운 매개변수:

exclusion=refundable_damage_deposit

장점:

파트너는 응답에 환불 가능 파손 보증금이 있는 요금이 포함되지 않도록 지정할 수 있습니다.


지리 폴리곤 및 예시 상세 설명 - Geography | Update | V3

좌표 요청 및 응답에서 Polygon 형식에 대한 세부 사양이 정확하지 않았습니다. 지리 엔드포인트와 관련한 API 탐색기에서 예제를 사용할 수 있도록 업데이트되었습니다.

이 변경은 API 기능에 영향을 미치지 않으며, OpenAPI 사양을 수정합니다.

Rapid 3 스키마 예시:

다음은 지역 응답의 일부를 정리한 예입니다.

"coordinates": {
      "center_longitude": -93.29277,
      "center_latitude": 37.207935,
      "bounding_polygon": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -93.298931,
              37.205162
            ],
            [
              -93.28672,
              37.205299
            ],
            [
              -93.286549,
              37.21005
            ],
            [
              -93.286763,
              37.210221
            ],
            [
              -93.298931,
              37.205162
            ]
          ]
        ]
      }
    },

장점:

이제 사양에서 지역이 Polygon 및 MultiPolygon 개체를 모두 반환할 수 있다는 점을 정확하게 반영합니다. 이와 함께, 폴리곤 검색을 위한 정확한 스키마와 예시를 제공합니다.

2022년 12월

Vrbo 예약 가능 여부 캘린더 - Shop | Feature | V3

Vrbo 예약 가능 여부 캘린더 엔드포인트인 "/calendars/availability"가 추가되었습니다.

Rapid 3 스키마 예시:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

장점:

Rapid 예약 가능 여부 캘린더 API는 일정 기간 동안 지정된 숙박 시설의 일일 예약 가능 여부에 대한 요약 정보를 제공하며, 숙박 시설 세부 정보 페이지를 확인하는 고객에게 도움이 될 수 있습니다.

자세한 내용은 여기에서 확인하실 수 있습니다.


강화된 숙박 시설 규정 - Content | Feature | V3

현재의 숙박 시설 규정을 대체하는 강화된 숙박 시설 규정이 Vrbo 숙박 시설의 Rapid 콘텐츠 API에 추가되었습니다.

Rapid 3 스키마 예시:

"enhanced_house_rules": {
        "CheckIn": {
            "rule": "Check in after 3:00 PM",
            "additional_information": []
        },
        "CheckOut": {
            "rule": "Check out before 11:00 AM",
            "additional_information": []
        },
        "Occupancy": {
            "rule": "Maximum overnight guests: 5 (sleeps up to 5 adults)",
            "additional_information": []
        },
        "MinBookingAge": {
            "rule": "Minimum age to rent: 18",
            "additional_information": []
        },
        "Children": {
            "rule": "Children allowed: ages 0-17",
            "additional_information": []
        },
        "Pets": {
            "rule": "Pets allowed: 1 pet less than 10kgs",
            "additional_information": [
                "Pets allowed under aproval/Se requiere aprobacion"
            ]
        },
        "Events": {
            "rule": "No Events allowed",
            "additional_information": []
        },
        "Smoking": {
            "rule": "Smoking allowed: outside",
            "additional_information": [
                "Silence is required after 10pm/Silencio 10pm",
                "At the balcony, Thank you! En el balcon, Gracias!"
            ]
        }
    }

장점:

강화된 숙박 시설 규정을 통해 자유 텍스트 형식의 호스트 메시지(정책별 제한/예외 사항 또는 고객의 숙박 관련 기타 정보 등)를 포함한 숙박 시설 정책을 더 명확하게 표시할 수 있습니다.


지리 기능 개선 - Geography | Feature | V3

지리 호출에서 다음과 같은 기능이 개선되었습니다.

  • Region, Regions 및 Properties within Polygon 요청에 supply_source 필터가 추가되었습니다.
  • Region, Regions 및 Properties within Polygon 응답에 Pagination-Total-Results 헤더가 추가되었습니다.
  • Regions 요청에 typecountry_code 필터가 추가되었습니다.

장점:

다양한 지리 호출에 대한 개선을 통해 파트너는 반환받을 결과를 보다 상세히 제어할 수 있습니다.

2022년 11월

환불 불가 기간 추가 - Shop | Manage Booking Feature | V3

예약 가능 여부 및 일정 응답에 환불 불가 기간이 추가되었습니다.

Rapid 3 스키마 예시:

"nonrefundable_date_ranges": [
    {
    "start": "2022-09-05",
    "end": "2022-09-11"
    }
   ],

장점:

휴일이나 다른 사유로 인해 공급업체가 설정한 환불 예외 사항을 파트너가 표시할 수 있어 여행객이 취소 시 환불 시기를 보다 잘 파악할 수 있습니다.


지역 응답에 카테고리 목록 및 태그 추가 - Geography | Feature | V3

모든 지역 응답에 카테고리 목록과 태그가 추가되었습니다.

Rapid 3 스키마 예시:

"categories": [
    "tourism:region"
],
"tags": [
    "geoAdmin:city"
]

장점:

파트너는 카테고리와 태그를 활용해 반환된 지역에 대한 메타데이터 정보를 얻을 수 있습니다.


Rapid 2.3 및 2.4 버전 지원 종료 - Remove | V2.4 | Breaking Change

Rapid API의 2.3 및 2.4 버전의 지원이 종료되었습니다.

2022년 10월

콘텐츠에 Vrbo Unit Configurations 추가 - Content | Feature | V3

콘텐츠 응답에 unit configuration 개체가 추가되었습니다.

Rapid 3 스키마 예시:

[
    {
        "property_id": "1234",
        "days": [
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            },
            {
                "date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
                "available": true,
                "checkin": "CHECKIN_VALID",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 14
                }
            }
        ]
    }
]

장점:

unit configuration은 객실 내 침대 유형과 해당 객실의 침대 유형별 현황을 설명합니다.

2022년 7월

중국어(홍콩) 언어 추가 - Content | Shopping | Feature | V3

중국어(홍콩)가 언어 옵션에 추가되었습니다. 이제 언어 매개변수가 지원되는 요청에서 "zh-HK" 언어 코드를 사용할 수 있습니다.

여기에서 지원되는 모든 언어의 목록을 확인하실 수 있습니다.


Vrbo 기본 숙박 정보 - Manage Booking | Feature | V3

일정 응답에 Vrbo 기본 숙박 정보가 추가되었습니다.

Rapid 3 스키마 예시:

"essential_information": {
  "contact": {
    "name": "John test",
    "phone": {
      "country_code": "1",
      "area_code": "367",
      "phone_number": "6876876"
    },
    "email": "dv@devmail.wvrgroup.internal",
    "address": {
      "line_1": "3rd St",
      "line_2": "421 W",
      "city": "Austin",
      "state_province_code": "TX",
      "postal_code": "86868",
      "country_code": "US"
    }
  },
  "essentials": [
    {
      "name": "directions",
      "instructions": "30.3079827,-97.8934852\n\nTurn right into the alley at the end of the road.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/a94d96e2-499b-4155-8872-6d0a4dd9a9db.large.jpg",
          "width": 1024,
          "height": 768
        },
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/e1713ff4-ad67-4498-93a1-befbdf5275a0.large.jpg",
          "width": 1024,
          "height": 768
        }
      ]
    },
    {
      "name": "wifi",
      "instructions": "Secure, hi speed wifi is available throughout the property.",
      "images": [
        {
          "url": "https://odis-stage.vrbo.com/odis/hospitality/caa47f61-3e7f-459b-bd74-e3cfe76a0edc.large.jpg",
          "width": 1024,
          "height": 768
        }
      ],
      "additional_info": {
        "network_name": "HomeNetwork",
        "network_password": "HomeNetwork1234567890"
      }
    },
    {
      "name": "thermostat",
      "instructions": "Thermostat\n\nDo not adjust thermostat below 59F/15C."
    }
  ],
  "updates_available_datetime": "2022-08-14T09:00:00-05:00"
}

장점:

Vrbo 기본 숙박 콘텐츠는 숙박 시설 주소 및 숙박 시설 관리자 연락처 정보를 포함하여 여행객에게 도착 전에 중요한 지침을 제공합니다. 여행객이 도착 시, 투숙 중 또는 체크아웃 시 필요할 수 있는 기타 주요 세부 정보가 포함될 수도 있습니다.

2022년 5월

모든 버전에 대해 ND4C(소비자를 위한 뉴딜) 규정 변경 - Shopping | Booking | Manage Booking | Feature | V3 | Breaking Change

ND4C(소비자를 위한 뉴딜) 규정이 비즈니스에 미치는 영향을 해소하고자 Rapid에 변경 사항이 적용되었습니다. 이 법은 유럽 연합(EU)과 영국 POS에 적용됩니다.

Rapid 3 스키마 예시:

"trader_information": {
  "traders":[
    {
       "name": "Expedia",
       "address": {
         "line_1": "555 1st St",
         "line_2": "10th Floor",
         "line_3": "Unit 12",
         "city": "Seattle",
         "state_province_code": "WA",
         "postal_code": "98121",
         "country_code": "US"
       },
      "email": "travel@support.expedia.com",
      "phone": "0330-123-1235",
      "contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business or profession."
     }
   ],
   "terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}

장점:

ND4C 규정 요건의 준수를 위해 파트너에게 거래자 정보를 제공합니다.


크로아티아어 및 리투아니아어 버전 지원 종료 - Content | Shopping | Remove | V3

크로아티아어 및 리투아니아어 버전의 지원이 종료되었습니다. 언어 매개변수를 사용하는 요청에 해당 언어의 전달을 시도하면 오류가 발생합니다.

2022년 4월

Rapid 2.3 및 2.4 버전 지원 중단 - Deprecated | V2.4 | Breaking Change

Rapid API의 2.3 및 2.4 버전의 지원이 중단되었습니다. 두 버전 모두 2022년 10월에 지원 종료됩니다.


Rapid 2.2 버전 지원 종료 - Remove | V2.2 | Breaking Change

Rapid API의 2.2 버전의 지원이 종료되었습니다.

2021년 9월

알림 테스트 API에 요청 본문 추가 - Notifications | Change | V3 | Breaking Change

이제 요청 본문이 요구됩니다.

Rapid 3 스키마 예시:

{
    "event_type": "itinerary.agent.create"
}

장점:

Rapid API의 전반적인 일관성을 보장합니다.


알림 전송 불가 API에 전송 불가 매개변수 추가 - Notifications | Change | V3 | Breaking Change

이제 새로운 전송 불가 쿼리 매개변수가 요구됩니다.

장점:

Rapid API의 전반적인 일관성을 보장합니다.


Shop과의 일관성 유지를 위해 Refundable Damage Deposit 및 Card On File Limit 필드 삭제 - Manage Booking | Change | V3 | Breaking Change

Shop과의 일관성 유지를 위해 Refundable Damage Deposit과 Card On File Limit 필드가 삭제되었습니다.

Rapid 3 스키마 예시:

"card_on_file_limit": {
  "value": "string",
  "currency": "string"
},
"refundable_damage_deposit": {
  "value": "string",
  "currency": "string"
},

장점:

파트너에 대한 스키마를 간소화합니다.


알림 API 엔드포인트 변경 - Notifications | Change | V3 | Breaking Change

알림 API 및 알림 전송 불가 API의 엔드포인트가 변경되었습니다(뒤에 오는 /{event_type}/undeliverable 삭제). 알림 테스트 API의 엔드포인트가 GET에서 POST로 변경되었습니다.

장점:

Rapid API의 전반적인 일관성을 보장합니다.


Shop과의 일관성 유지를 위해 Deposit Policy를 Deposit으로 이름 변경 - Manage Booking | Change | V3 | Breaking Change

Shop과의 일관성 유지를 위해 Deposit Policy 개체의 이름이 Deposits로 변경되었습니다.

Rapid 2.4 스키마 예시:

"deposit_policies": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

Rapid 3 스키마 예시:

"deposits": [
  {
    "amount": "220.75",
    "due": "2018-12-12T01:01:01.000-08:00"
  }
],

장점:

파트너에 대한 스키마를 간소화합니다.


TripAdvisor 콘텐츠 API 엔드포인트 지원 중단 - Content | Deprecate | V3 | Breaking Change

Expedia Group은 더 이상 TripAdvisor와 비즈니스 관계를 유지하지 않기 때문에 Rapid 3에서 TripAdvisor 콘텐츠 API 지원이 중단됩니다.

장점:

파트너는 중복된 엔드포인트를 호출할 수 없습니다.


로열티 ID 추가 - Booking | Manage Booking | Feature | V3 | Breaking Change

파트너가 호텔 로열티 ID를 제공할 수 있는 새로운 기능이 추가되었습니다.

  • 이 객실 투숙객과 관련이 있는 호텔 로열티 프로그램의 식별자입니다.
  • rooms 개체 아래에 있습니다.

Rapid 3 스키마 예시:

"rooms": [
  {
    "given_name": "John",
    "family_name": "Smith",
    "smoking": false,
    "special_request": "Top floor or away from street please",
    "loyalty_id": "ABC123"
  }
],

참고: 새로운 필드는 여러 위치에 있습니다.

  • 예약 요청 생성
  • 일정 확인
  • 일정 변경

장점:

파트너가 호텔 로열티 ID가 포함된 정보를 호텔에 전달할 수 있습니다.

*정보 제공을 목적으로 하며, 호텔의 추가 포인트나 혜택 제공을 보장하지 않습니다.


Rapid 예약 가능 여부 응답에 보증금 데이터 추가 - Shopping | Feature | V3

파트너는 Rapid 3에서 별도의 보증금(결제 일정) 정보를 호출할 필요가 없습니다. 대신 이 데이터가 Rate 개체의 하위에 표시됩니다.

보증금(결제 일정) 데이터에 대한 추가 호출 필요성을 제거하고 노출도 향상을 위해 priceCheck 응답에서 데이터를 사용할 수 있도록 변경됩니다.

Rapid 3 스키마 예시:

"deposits": [
  {
    "value": "70.00",
    "due": "2021-08-21",
    "currency": "CAD"
  }
]

이제 Rapid 3에서 보증금 데이터 검색을 목적으로 보증금 링크를 반환할 필요가 없으며, 데이터는 응답에 표시됩니다.

Rapid 2.4 스키마 예시:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  },
  "deposit_policies": {
    "method": "GET",
    "href": "/2.4/properties/19248/deposit-policies?token=MY5S3j36cOcL"
  }
}

Rapid 3 스키마 예시:

"links": {
  "payment_options": {
    "method": "GET",
    "href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
  }
}

Rapid 3은 새로운 보증금 배열과 중복되기 때문에 더 이상 deposit_required 필드를 반환하지 않습니다.

Rapid 2.4 스키마 예시:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"deposit_required": true,
"merchant_of_record": "expedia",

Rapid 3 스키마 예시:

"sale_scenario": {
  "package": false,
  "member": true,
  "corporate": false,
  "distribution": false
},
"merchant_of_record": "expedia",

장점:

파트너는 더 이상 데이터에 대해 추가 호출을 할 필요가 없으며, 데이터는 응답에 포함됩니다.


priceCheck 응답에서 휴가용 주택에 대한 card_on_file_limit 및 refundable_damage_deposit 지원 추가 - Shopping | Feature | V3

휴가용 주택 관련 데이터가 추가되었습니다. card_on_file_limit은 숙박 시설 파손에 대해 카드에 청구할 수 있는 최대 금액이며, refundable_damage_deposit은 숙박 시설에서 요구하는 보증금입니다. 응답에는 하나의 값만 사용할 수 있으며, 지정된 요금에 대해 두 개의 값이 파트너에게 반환되지 않습니다.

Rapid 3 스키마 예시:

"card_on_file_limit": {
  "value": "25.00",
  "currency": "CAD"
},
"refundable_damage_deposit": {
  "value": "75.00",
  "currency": "CAD"
}

장점:

파트너는 휴가용 주택 숙박 시설의 보증금과 예상 데이터를 모두 파악할 수 있습니다.


숙박 시설 콘텐츠 API/파일 및 숙박 시설 카탈로그 파일에 supply_source 필수 필드 추가 - Content | Feature | V3 | Breaking Change

파트너가 반환할 재고 유형을 지정할 수 있도록 숙박 시설 콘텐츠 API/파일 및 숙박 시설 카탈로그 파일에 필수 필드인 supply_source가 새로 추가되었습니다.

예를 들어, 'expedia' 값을 전달하면 Expedia의 재고만 반환합니다.

'vrbo' 값을 전달하면 Vrbo의 재고만 반환합니다.

Rapid 3 스키마 예시:

"supply_source": "vrbo"

참고: supply_source는 이제 필수 필드로 지정되었습니다. 파트너가 이전 버전의 API와 동일한 동작을 달성하려면 "supply_source": "expedia"를 전달해야 합니다.

장점:

파트너는 Expedia 재고와 동일한 엔드포인트를 통해 Vrbo 재고에 액세스할 수 있습니다.


숙박 시설 콘텐츠 API/파일에 추가된 새로운 섹션을 휴가용 주택 특정 숙박 시설과 객실 정보와 통합 - Content | Feature | V3 | Breaking Change

Rapid 콘텐츠/파일에 새로운 섹션이 추가되었습니다. 파트너는 이곳에서 복수 유닛 숙박 시설의 객실 설명에서 일반적으로 찾을 수 있는 숙박 시설을 포함한 휴가용 주택 관련 숙박 시설 정보를 찾을 수 있습니다.

이제 파트너의 결제 페이지에서 임대 계약을 표시하는 것이 휴가용 주택 숙박 시설에 대한 Rapid 출시 요구 사항이 되었습니다.

Rapid 3 스키마 예시:

"vacation_rental_details": {
  "property_registration":{
  },
  "private_host"{
  },
  "property_manager": {
    "name": "Frans Belderbos",
    "links": {
      "image": {
        "method": "GET",
        "href": "https://odis.vrbo.com/odis/story/89cd116a-14fd-4fbc-a0d1-861894171cd0.c1.jpg"
      }
    },
    "rental_agreement": {
      "links": {
        "rental_agreement": {
          "method": "GET",
          "href": "https://www.vrbo.com/td/proxies/ecomQuote/downloadRentalAgreement?unitUrl=/units/0000/1341f175-3550-4c80-b9a1-b6b330b7e032"
        }
      }
    },
    "house_rules": [
        "Children welcome",
        "Pets welcome (restrictions apply)",
        "No smoking",
        "No parties or events"
      ],
    "amenities": {
        "1073743284": {
            "id": "1073743284",
            "name": "Heating"
        },
        "4296": {
            "id": "4296",
            "name": "Furnished balcony or patio"
        }
    }
  }
}

장점:

콘텐츠 응답의 휴가용 주택 관련 섹션에서 단일 유닛 휴가용 주택에 대한 숙박 시설 표시를 개선할 수 있는 더 많은 숙박 시설 세부 정보가 제공됩니다.


PSD2에 대한 제3자 인증 - Booking | Feature | V3 | Breaking Change

파트너가 PSD2 준수를 위해 선호하는 결제 서비스 공급업체를 이용할 수 있도록 하는 새로운 상품입니다.

cavv, eci, three_ds_versionds_transaction_id 매개변수가 필요합니다.

Rapid 3 스키마 예시:

"third_party_authentication": {
  "cavv": "jELUbgG+Tgj0AREBDMLeCad+oIs=",
  "eci": "05",
  "three_ds_version": "2.2.0",
  "ds_transaction_id": "ac01cc2b-c1a1-4981-8c6f-400d4eec88de",
  "pa_res_status": "Y",
  "ve_res_status": "C",
  "xid": "47133847-13be-4ae3-9be9-e4053b9c83c0",
  "cavv_algorithm": "3",
  "ucaf_indicator": "0"
}

장점:

파트너가 PSD2 준수를 위해 선호하는 결제 서비스 공급업체를 이용할 수 있습니다.


보안 버그 수정을 위한 특수 문자 인코딩 추가 - Booking | Bug Fix | V3 | Breaking Change

보안상의 취약점으로부터 보호하기 위해 여러 필드의 특수 문자가 다시 인코딩됩니다.

장점:

잠재적인 보안상의 취약점을 제거합니다.


Price Check 테스트 헤더 수정 - Shopping | Bug Fix | V3

Price Check 호출에 대해 유효하지 않은 테스트 헤더가 유효한 값과 일치하도록 이름이 변경되었습니다.

Rapid 2.4 스키마 예시:

--header "Test: matched"

Rapid 3 스키마 예시:

--header "Test: available"

장점:

파트너가 Price Check과의 통합을 더욱 완벽하게 테스트할 수 있습니다.


Customer_account_Details 열거형에서 오타 수정 - Booking | Bug Fix | V3 | Breaking Change

customer_account_details 열거형에서 오타를 수정해 "fido_authenticaton"을 "fido_authentication"으로 변경했습니다.

Rapid 2.4 스키마 예시:

"customer_account_details": {
  "authentication_method": "fido_authenticaton",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

Rapid 3 스키마 예시:

"customer_account_details": {
  "authentication_method": "fido_authentication",
  "authentication_timestamp": "2018-02-12T11:59:00.000Z",
  "create_date": "2018-09-15",
  "change_date": "2018-09-17",
  "password_change_date": "2018-09-17",
  "add_card_attempts": 1,
  "account_purchases": 1
},

장점:

혼동될 수 있는 오탈자가 삭제되었습니다.


교차 판매 및 대체 숙박 시설 추천 삭제 - Recommendations | Remove | V3 | Breaking Change

reference_property_id, destination_iata_airport_code, origin_iata_airport_codeiata_airline_code 매개변수가 삭제되었습니다. 이제는 추천 링크가 더 이상 응답에 표시되지 않습니다.

Rapid 2.4 스키마 예시:

"recommendations": {
  "method": "GET",
  "href": "/2.4/properties/availability?token=abcdef"
}

장점:

파트너는 중복 요청 매개변수를 사용하여 호출할 수 없습니다.


Fees 개체에서 지원 중단된 필드 삭제 - Shopping | Booking | Manage Booking | Remove | V3 | Breaking Change

정보 제공 용도로만 사용되며 총 수수료를 표시하는 데 혼란을 야기하는 필드를 제거해 Fees 개체를 단순화했습니다.

Rapid 2.4 스키마 예시:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    },
    "scope": "per_person",
    "frequency": "per_day"
  }
}

Rapid 3 스키마 예시:

"fees": {
  "mandatory_fee": {
    "billable_currency": {
      "value": "5.00",
      "currency": "CAD"
    },
    "request_currency": {
      "value": "3.00",
      "currency": "USD"
    }
  }
}

장점:

청구된 수수료를 정확하게 파악할 수 있도록 scope 및 frequency가 삭제되었습니다. 이를 통해 불필요한 필드를 삭제하고 파트너에 대한 스키마를 간소화합니다.


/properties/{property_id}/deposit-policies 경로 삭제 - Shopping | Remove | V3

deposit-policies 엔드포인트는 이제 예약 가능 객실 직접 호출에 포함되기 때문에 삭제됩니다.

장점:

파트너는 보증금 정책 정보의 확인을 위해 추가 호출을 수행할 필요가 없습니다.


Postal Code 필드 설명 상세 규정 - Booking | Update | V3

혼동을 방지하기 위해 Postal Code 필드의 설명이 단순화되었습니다.

Rapid 2.4 스키마 예시:

고객의 우편번호입니다. 결제 유형이 신용카드(CC, CCC, VCC)이며 국가 코드가 US, GB, CA인 경우 Postal_Code는 필수 항목입니다.

Rapid 3 스키마 예시:

우편번호입니다.

장점:

해당 필드가 반드시 요구되는 경우를 자세히 설명합니다.


Rate Plan Count 설명 상세 규정 - Shopping | Update | V3

Rate Plan Count 필드 설명이 업데이트되었습니다. 최소 및 최대한도가 포함되며, 필드가 반환하려는 항목(예약 가능한 최적가)을 상세히 규정합니다.

Rapid 2.4 스키마 예시:

숙박 시설당 반환할 요금의 수입니다. 요금의 가격은 반환되는 요금을 결정합니다. 예를 들어, rateplancount=4는 최저 요금 4개를 반환하지만 최저가 또는 최고가 순으로 정렬되지 않습니다. 최저 요금이 최적의 전환율을 보이는 것으로 입증되어 권장되는 값은 1입니다. 이 값은 0보다 커야 합니다.

Rapid 3 스키마 예시:

숙박 시설당 반환할 요금의 수입니다. 최고 가성비를 선보이는 요금이 반환됩니다. 예를 들어, rate_plan_count=4는 최고 가성비 요금 4개를 반환하지만 최저가 또는 최고가 순으로 정렬되지 않습니다. 일반적으로 최저 요금이 우선 적용됩니다. 이 값은 1에서 250 사이여야 합니다.

장점:

필드에 유효한 값을 상세히 규정합니다.


State Province Code 설명 상세 규정 - Booking | Update | V3

혼동을 방지하기 위해 State Province Code 필드의 설명이 단순화되었습니다.

Rapid 2.4 스키마 예시:

고객의 주/도 코드입니다. country_code가 US, AU 또는 CA인 경우 필수 항목입니다.

Rapid 3 스키마 예시:

호주, 캐나다와 미국에서 사용되는 2자리 또는 3자리 주/도 코드입니다.

장점:

해당 필드가 반드시 요구되는 경우를 자세히 설명합니다.

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