라이브 데모

호텔 API 연동

RateHawk API 연동: API 키부터 실제 호텔 예약까지

RateHawk 계정을 PHPTRAVELS에 연결하고 자사 웹사이트와 에이전트 포털에서 RateHawk의 호텔과 아파트를 판매하세요. 커넥터는 이미 준비되어 있습니다. API 키를 등록하고, 호텔 데이터베이스를 가져오고, 마크업을 설정한 뒤 RateHawk 인증을 받으면 됩니다.

  • 바로 쓰는 RateHawk 커넥터
  • ETG API v3
  • 호텔 덤프 가져오기
  • 넷 요금에 자사 마크업

공급사

RateHawk는 무엇이며, 여행사가 연동하는 이유

RateHawk는 Emerging Travel Group(ETG)이 여행사, 투어 운영사, 여행 기업을 위해 운영하는 B2B 예약 플랫폼입니다. 파트너는 RateHawk 자체 포털 또는 API를 통해 호텔, 아파트 및 기타 숙소를 넷 요금으로 예약합니다.

이 API의 이름은 ETG API이며, 현재 버전은 v3입니다. JSON 요청과 응답을 사용하는 REST API로 검색, 예약, 취소를 지원합니다. PHPTRAVELS는 숙박 모듈에 RateHawk 커넥터를 제공하므로, RateHawk 결과가 다른 호텔 공급사 및 자체 계약 객실과 나란히 표시됩니다.

관련:숙소호텔 예약 엔진여행 API

공급사 정보
회사
RateHawk, Emerging Travel Group 계열
유형
여행 전문가를 위한 B2B 숙박 플랫폼
재고
RateHawk 발표 기준 260만 개 이상의 숙소
API 파트너
RateHawk 2024년 발표 기준 700곳 이상의 API 고객
API
ETG API v3 · REST · JSON
PHPTRAVELS에서
숙박 모듈에 바로 쓰는 커넥터

ETG API v3 예약 흐름

RateHawk 예약이 진행되는 단계별 과정

모든 RateHawk 예약은 같은 다섯 단계를 거칩니다. 단계마다 그 뒤에서 호출되는 ETG API와 PHPTRAVELS가 대신 처리하는 일을 정리했습니다.

  1. 01

    검색

    ETG API 호출

    지역별 · 지리 좌표별 · 호텔 ID별 검색

    PHPTRAVELS

    도시, 지도 영역 또는 호텔 목록으로 날짜, 인원, 여행자의 거주 국가와 함께 검색하고, 마크업을 적용한 실시간 넷 요금을 표시합니다.

  2. 02

    호텔 페이지

    ETG API 호출

    호텔 페이지 조회

    PHPTRAVELS

    선택한 호텔의 모든 객실과 요금을 불러옵니다. 식사 조건, 세금, 취소 정책, 결제 방식을 포함합니다.

  3. 03

    사전 예약

    ETG API 호출

    요금 사전 예약 · 요금 정보 조회

    PHPTRAVELS

    결제 직전에 선택한 요금이 같은 가격으로 여전히 예약 가능한지 확인하고, 변경되었다면 결제를 중단합니다.

  4. 04

    예약

    ETG API 호출

    예약 프로세스 생성, 시작, 확인

    PHPTRAVELS

    예약을 생성하고 투숙객 정보를 전송한 뒤 확정될 때까지 상태를 추적하고 RateHawk 주문 ID를 저장합니다.

  5. 05

    예약 이후

    ETG API 호출

    예약 조회 · 예약 취소 · 상태 웹훅

    PHPTRAVELS

    바우처를 발송하고, 관리자와 고객 계정에 예약을 표시하며, 요금의 정책에 따라 취소를 처리합니다.

정적 데이터

RateHawk 호텔 데이터베이스는 한 번 가져오고 최신으로 유지

검색 결과에는 요금만 들어 있습니다. 호텔 이름, 주소, 사진, 편의시설, 설명은 ETG의 정적 데이터에서 오며, PHPTRAVELS가 이를 호텔 페이지로 가져옵니다.

  • 지역 덤프

    국가, 도시, 지역 정보로 여행자가 목적지로 검색할 수 있습니다.

  • 호텔 덤프

    전체 호텔 콘텐츠 파일: 이름, 주소, 좌표, 사진, 편의시설, 설명.

  • 증분 덤프

    마지막 가져오기 이후 변경된 내용만 담아, 전체를 다시 불러오지 않고도 카탈로그를 최신으로 유지합니다.

  • 리뷰 덤프

    호텔 페이지에 표시할 투숙객 리뷰 점수와 내용으로, 계약에 포함된 경우 제공됩니다.

호텔 콘텐츠 가져오기
  • 지역 덤프100%
  • 호텔 덤프100%
  • 증분 덤프64%
  • 리뷰 덤프30%

예시 화면입니다. 건수는 계정과 언어에 따라 다릅니다.

ETG는 덤프 파일 외에도 호텔 데이터를 필요할 때 조회하는 Content API를 제공합니다.

API 키와 샌드박스

RateHawk API 인증 방식

ETG API는 HTTP Basic 인증을 사용합니다. 키 ID가 사용자 이름, API 키가 비밀번호이며, 모든 요청마다 HTTPS로 전송됩니다.

샌드박스 검색 요청(예시)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
두 개의 호스트
샌드박스: api-sandbox.ratehawk.com. 테스트와 운영: api.ratehawk.com. 기존 worldota.net 호스트는 더 이상 권장되지 않습니다.
테스트 호텔은 실제 호텔
테스트 키로는 hid 8473727 테스트 호텔만 예약할 수 있으며, 이 예약은 실제 예약으로 실제 재무 책임이 따릅니다. 테스트 직후 바로 취소하세요.
키는 서버에만 보관
PHPTRAVELS는 키 ID와 API 키를 서버 설정에 보관하며, 브라우저나 앱에는 절대 두지 않습니다.
거주 국가가 중요
요금은 여행자의 거주 국가에 따라 달라지므로, 커넥터는 검색할 때마다 이를 함께 전송합니다.

PHPTRAVELS에서 설정

네 단계로 RateHawk 커넥터 설정

코드를 작성할 필요가 없습니다. 커넥터는 관리자 패널에서 설정합니다.

  1. 01API 키 등록RateHawk에서 받은 키 ID와 API 키를 붙여 넣습니다. 먼저 샌드박스용, 이후 운영용을 등록합니다.
  2. 02호텔 데이터베이스 가져오기지역 덤프와 호텔 덤프를 불러온 뒤 증분 업데이트를 예약합니다.
  3. 03마크업과 통화 설정채널, 에이전트 그룹 또는 목적지별로 비율 또는 고정 마크업을 판매 통화로 설정합니다.
  4. 04테스트 후 오픈테스트 예약과 취소를 진행하고 인증을 통과한 뒤 운영 키로 전환합니다.
공급사 › RateHawkRateHawk

환경

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

키 ID4127
API 키••••••••••••••••
마크업넷 요금에 12%
통화USD · EUR · GBP
기본 거주 국가GB

예시 설정 화면입니다.

인증

계약부터 운영 환경 접근까지

RateHawk는 계약이 체결되고 연동이 인증을 통과한 뒤에만 운영 환경을 엽니다.

  1. 1

    API 계약 체결

    고객사

    여행 기업으로서 RateHawk에 연락해 해당 시장에 대한 API 계약을 체결합니다.

  2. 2

    샌드박스 키 수령

    RateHawk

    RateHawk가 샌드박스용 키 ID와 API 키를 발급합니다.

  3. 3

    연결과 가져오기

    PHPTRAVELS

    키를 PHPTRAVELS에 등록하고, 정적 데이터를 가져오고, 마크업을 설정합니다.

  4. 4

    인증 통과

    RateHawk

    RateHawk가 예약, 상태, 취소 흐름을 포함해 연동을 점검합니다.

  5. 5

    운영 환경 접근

    고객사

    운영 키를 관리자에 등록하면 실제 예약이 시작됩니다.

포털, API 또는 엔진

RateHawk 호텔을 판매하는 세 가지 방법

에이전트는 지금도 RateHawk 자체 웹사이트에서 예약할 수 있습니다. RateHawk 호텔을 자사 브랜드로 판매하게 해 주는 것은 자사 예약 엔진 안의 API입니다.

  • RateHawk 웹사이트

    예약 주체
    자사 에이전트, 한 번에 한 건씩
    브랜드
    RateHawk
    필요한 작업
    에이전트로 가입 후 로그인

  • 자체 API 개발

    예약 주체
    고객과 에이전트, 온라인
    브랜드
    자사
    필요한 작업
    수개월의 개발과 인증

  • PHPTRAVELS + RateHawk

    예약 주체
    고객과 에이전트, 온라인
    브랜드
    자사
    필요한 작업
    설정, 콘텐츠 가져오기, 인증

멀티 공급사

다른 호텔 공급사와 나란히 놓이는 RateHawk

RateHawk는 숙박 모듈의 공급사 중 하나입니다. 같은 검색에 다른 호텔 API와 자체 계약 객실을 함께 포함할 수 있으며, 공급사별로 마크업과 라우팅을 설정합니다.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
가격 보기호텔 데모 체험

에이전트 가이드 읽기

자주 묻는 질문

RateHawk API 연동 질문

여행사가 RateHawk를 연동하기 전에 묻는 질문들.

영업팀 문의

RateHawk는 API 이용 수수료를 공개하지 않습니다. API 계약을 체결한 뒤 넷 요금에 자사 마크업을 더해 호텔을 판매합니다. 비용은 예약 소프트웨어, 호스팅, 결제에 듭니다.

여행 기업으로서 RateHawk에 연락해 API 계약을 체결하세요. 이후 RateHawk가 샌드박스용 키 ID와 API 키를 발급하고, 인증 후 운영 키를 발급합니다.

ETG API 문서는 docs.emergingtravel.com에 온라인으로 공개되어 있으며, B2B API, Content API, 샌드박스와 인증 가이드를 담고 있습니다. 별도로 내려받는 PDF는 없으며, 온라인 문서가 최신 버전입니다.

ETG API는 RateHawk를 운영하는 회사인 Emerging Travel Group의 API입니다. RateHawk API 연동과 ETG API 연동은 같은 의미이며, 현재 버전은 v3입니다.

PHPTRAVELS는 US$2,499부터 시작하는 1회 구매 라이선스로 전체 소스 코드가 제공되며, RateHawk 커넥터는 숙박 모듈에 포함되어 있습니다. RateHawk와의 상업 조건은 RateHawk와 직접 합의합니다.

네, api-sandbox.ratehawk.com에 있습니다. 테스트 키로는 hid 8473727 테스트 호텔만 예약할 수 있고 이 예약은 실제 예약이므로, 테스트 직후 바로 취소하세요.

에이전트는 포털에서 예약하기 위해 ratehawk.com에 가입하고 로그인합니다. API 접근은 별개로, 포털 로그인이 아니라 계약에 따른 키 ID와 API 키를 사용합니다.

커넥터가 이미 있으므로 시간은 개발이 아니라 계약, 키 등록, 호텔 콘텐츠 가져오기, RateHawk 인증에 들어갑니다.

네. 같은 커넥터가 B2C 웹사이트와 B2B 에이전트 포털을 모두 지원하며, 채널과 에이전트 그룹별로 마크업을 따로 설정할 수 있습니다.

각 요금에는 취소 정책이 있으며 결제 전에 표시됩니다. 취소는 관리자 또는 고객 계정에서 해당 정책에 따라 예약 취소 호출로 실행됩니다.

더 둘러보기

플랫폼 더 알아보기