Tích hợp API khách sạn
Tích hợp API RateHawk: từ API key đến đặt phòng thật
Kết nối tài khoản RateHawk với PHPTRAVELS và bán khách sạn, căn hộ của RateHawk trên website và cổng đại lý của riêng bạn. Connector đã sẵn sàng: thêm API key, nhập cơ sở dữ liệu khách sạn, đặt markup và hoàn tất chứng nhận của RateHawk.
- Connector RateHawk có sẵn
- ETG API v3
- Nhập dump khách sạn
- Markup riêng trên giá net
Nhà cung cấp
RateHawk là gì và vì sao các đại lý kết nối
RateHawk là nền tảng đặt phòng B2B của Emerging Travel Group (ETG) dành cho đại lý du lịch, nhà điều hành tour và công ty du lịch. Đối tác đặt khách sạn, căn hộ và các loại lưu trú khác theo giá net, trên cổng riêng của RateHawk hoặc qua API của họ.
API này có tên ETG API. Phiên bản hiện tại là v3, một REST API với request và response dạng JSON, bao gồm tìm kiếm, đặt phòng và hủy. PHPTRAVELS có sẵn connector RateHawk trong module lưu trú, nên kết quả RateHawk hiển thị cạnh các nhà cung cấp khách sạn khác và các hợp đồng riêng của bạn.
- Công ty
- RateHawk, thuộc Emerging Travel Group
- Loại hình
- Nền tảng lưu trú B2B cho người làm du lịch
- Quỹ phòng
- Hơn 2,6 triệu lựa chọn lưu trú, theo RateHawk
- Đối tác API
- Hơn 700 khách hàng API, theo RateHawk năm 2024
- API
- ETG API v3 · REST · JSON
- Trong PHPTRAVELS
- Connector có sẵn trong module lưu trú
Quy trình đặt phòng ETG API v3
Một đặt phòng RateHawk diễn ra qua từng giai đoạn
Mọi đặt phòng RateHawk đều đi qua cùng năm giai đoạn. Mỗi giai đoạn liệt kê các lệnh gọi ETG API phía sau và những gì PHPTRAVELS làm thay bạn.
- 01
Tìm kiếm
Lệnh gọi ETG API
Tìm theo khu vực · theo tọa độ địa lý · theo ID khách sạn
PHPTRAVELS
Tìm theo thành phố, vùng trên bản đồ hoặc danh sách khách sạn, kèm ngày, số khách và nơi cư trú của khách, rồi hiển thị giá net trực tiếp đã cộng markup của bạn.
- 02
Trang khách sạn
Lệnh gọi ETG API
Lấy trang khách sạn
PHPTRAVELS
Tải mọi phòng và giá của khách sạn đã chọn: gói ăn, thuế, chính sách hủy và hình thức thanh toán.
- 03
Đặt trước
Lệnh gọi ETG API
Đặt trước giá · Lấy thông tin giá
PHPTRAVELS
Kiểm tra giá đã chọn vẫn còn với đúng mức đó ngay trước khi thanh toán, và dừng thanh toán nếu giá đã thay đổi.
- 04
Đặt phòng
Lệnh gọi ETG API
Tạo, bắt đầu và kiểm tra quy trình đặt phòng
PHPTRAVELS
Tạo đặt phòng, gửi thông tin khách, theo dõi trạng thái đến khi được xác nhận và lưu mã đơn hàng RateHawk.
- 05
Sau khi đặt
Lệnh gọi ETG API
Lấy danh sách đặt phòng · Hủy đặt phòng · Webhook trạng thái
PHPTRAVELS
Gửi voucher, hiển thị đặt phòng trong trang quản trị và tài khoản khách hàng, và xử lý hủy theo chính sách của giá.
Dữ liệu tĩnh
Nhập cơ sở dữ liệu khách sạn RateHawk một lần, rồi luôn cập nhật
Kết quả tìm kiếm chỉ chứa giá. Tên, địa chỉ, ảnh, tiện nghi và mô tả đến từ dữ liệu tĩnh của ETG, được PHPTRAVELS nhập vào các trang khách sạn của bạn.
Dump khu vực
Quốc gia, thành phố và khu vực, để khách có thể tìm theo điểm đến.
Dump khách sạn
Tệp nội dung khách sạn đầy đủ: tên, địa chỉ, tọa độ, ảnh, tiện nghi và mô tả.
Dump gia tăng
Chỉ những gì thay đổi kể từ lần nhập trước, để danh mục luôn mới mà không cần tải lại toàn bộ.
Dump đánh giá
Điểm và nội dung đánh giá của khách để hiển thị trên trang khách sạn, nếu thỏa thuận của bạn bao gồm phần này.
- Dump khu vực100%
- Dump khách sạn100%
- Dump gia tăng64%
- Dump đánh giá30%
Màn hình mẫu. Số lượng tùy thuộc vào tài khoản và ngôn ngữ của bạn.
Bên cạnh các tệp dump, ETG còn cung cấp Content API để lấy dữ liệu khách sạn theo yêu cầu.
API key và sandbox
Cách xác thực API RateHawk hoạt động
ETG API dùng xác thực HTTP Basic. Key ID là tên người dùng và API key là mật khẩu, được gửi qua HTTPS trong mọi request.
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
- Hai host
- Sandbox: api-sandbox.ratehawk.com. Kiểm thử và production: api.ratehawk.com. Các host worldota.net cũ đã bị ngừng khuyến nghị.
- Khách sạn thử nghiệm là thật
- Key thử nghiệm chỉ được đặt khách sạn thử nghiệm có hid 8473727, và đặt phòng đó là thật, kèm trách nhiệm tài chính thật. Hãy hủy ngay sau khi kiểm thử.
- Key chỉ nằm trên máy chủ
- PHPTRAVELS lưu key ID và API key trong cấu hình máy chủ, không bao giờ trong trình duyệt hay ứng dụng.
- Nơi cư trú rất quan trọng
- Giá phụ thuộc vào nơi cư trú của khách, nên connector gửi thông tin này trong mọi lượt tìm kiếm.
Cài đặt trong PHPTRAVELS
Cài đặt connector RateHawk trong bốn bước
Không cần viết code: connector được cấu hình trong trang quản trị.
- 01Thêm API keyDán key ID và API key từ RateHawk, trước tiên cho sandbox, sau đó cho production.
- 02Nhập cơ sở dữ liệu khách sạnTải dump khu vực và dump khách sạn, rồi lên lịch cập nhật gia tăng.
- 03Đặt markup và tiền tệMarkup theo phần trăm hoặc cố định, theo kênh, nhóm đại lý hoặc điểm đến, bằng các loại tiền bạn bán.
- 04Kiểm thử và chạy thậtThực hiện đặt phòng và hủy thử nghiệm, vượt qua chứng nhận, rồi chuyển sang key production.
Môi trường
https://api-sandbox.ratehawk.comhttps://api.ratehawk.com
Màn hình cài đặt mẫu.
Chứng nhận
Từ thỏa thuận đến quyền truy cập production
RateHawk chỉ mở production sau khi thỏa thuận được ký và bản tích hợp của bạn vượt qua chứng nhận.
- 1
Ký thỏa thuận API
BạnLiên hệ RateHawk với tư cách công ty du lịch và ký thỏa thuận API cho các thị trường của bạn.
- 2
Nhận key sandbox
RateHawkRateHawk cấp key ID và API key cho sandbox.
- 3
Kết nối và nhập dữ liệu
PHPTRAVELSKey được nhập vào PHPTRAVELS, dữ liệu tĩnh được nhập và markup được thiết lập.
- 4
Vượt qua chứng nhận
RateHawkRateHawk kiểm tra bản tích hợp, bao gồm quy trình đặt phòng, trạng thái và hủy.
- 5
Quyền truy cập production
BạnKey production được nhập vào trang quản trị và đặt phòng thật bắt đầu.
Cổng, API hay hệ thống đặt phòng
Ba cách bán khách sạn RateHawk
Đại lý có thể đặt phòng ngay hôm nay trên website của RateHawk. Còn API, đặt trong hệ thống đặt phòng của riêng bạn, mới là thứ đưa khách sạn RateHawk về dưới thương hiệu của bạn.
Website RateHawk
- Ai đặt phòng
- Đại lý của bạn, từng đặt phòng một
- Thương hiệu của ai
- RateHawk
- Cần làm gì
- Đăng ký làm đại lý và đăng nhập
Tự xây dựng tích hợp API
- Ai đặt phòng
- Khách hàng và đại lý của bạn, trực tuyến
- Thương hiệu của ai
- Của bạn
- Cần làm gì
- Nhiều tháng phát triển và chứng nhận
PHPTRAVELS với RateHawk
- Ai đặt phòng
- Khách hàng và đại lý của bạn, trực tuyến
- Thương hiệu của ai
- Của bạn
- Cần làm gì
- Cấu hình, nhập nội dung và chứng nhận
Đa nhà cung cấp
RateHawk bên cạnh các nhà cung cấp khách sạn khác
RateHawk là một nhà cung cấp trong module lưu trú. Cùng một lượt tìm kiếm có thể gồm các API khách sạn khác và hợp đồng riêng của bạn, với markup và định tuyến theo từng nhà cung cấp.
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
Câu hỏi thường gặp
Câu hỏi về tích hợp API RateHawk
Những điều các đại lý hỏi trước khi kết nối RateHawk.
Liên hệ kinh doanhRateHawk không công bố phí truy cập API. Bạn ký thỏa thuận API và bán khách sạn của họ theo giá net cộng markup của riêng bạn. Chi phí của bạn là phần mềm đặt phòng, hosting và thanh toán.
Liên hệ RateHawk với tư cách công ty du lịch và ký thỏa thuận API. Sau đó RateHawk cấp key ID và API key cho sandbox, và key production sau khi chứng nhận.
Tài liệu ETG API có trực tuyến tại docs.emergingtravel.com, gồm B2B API, Content API, hướng dẫn sandbox và chứng nhận. Không có tệp PDF riêng để tải về; tài liệu trực tuyến là phiên bản hiện hành.
ETG API là API của Emerging Travel Group, công ty đứng sau RateHawk. Tích hợp API RateHawk và tích hợp ETG API là cùng một việc; phiên bản hiện tại là v3.
PHPTRAVELS là giấy phép trả một lần từ 2.499 US$ kèm toàn bộ mã nguồn, và connector RateHawk đã có trong module lưu trú. Điều khoản thương mại với RateHawk do bạn thỏa thuận trực tiếp với RateHawk.
Có, tại api-sandbox.ratehawk.com. Lưu ý key thử nghiệm chỉ được đặt khách sạn thử nghiệm có hid 8473727, và đặt phòng đó là thật, nên hãy hủy ngay sau khi kiểm thử.
Đại lý đăng ký và đăng nhập trên ratehawk.com để đặt phòng trong cổng. Quyền truy cập API là riêng biệt: dùng key ID và API key theo thỏa thuận, không phải thông tin đăng nhập cổng.
Connector đã có sẵn, nên thời gian dành cho thỏa thuận, thêm key, nhập nội dung khách sạn và chứng nhận của RateHawk, chứ không phải phát triển.
Có. Cùng một connector phục vụ website B2C và cổng đại lý B2B của bạn, với markup riêng cho từng kênh và nhóm đại lý.
Mỗi giá đi kèm chính sách hủy riêng, được hiển thị trước khi thanh toán. Việc hủy được thực hiện từ trang quản trị hoặc tài khoản khách hàng qua lệnh gọi hủy đặt phòng, theo đúng chính sách đó.
Khám phá thêm
Thêm về nền tảng
- Tích hợp API HotelbedsGiá, đặt phòng và voucher Hotelbeds theo thời gian thực
- Tích hợp API khách sạn TBOGiá khách sạn TBO Holidays trong công cụ đặt chỗ của bạn
- Tích hợp API ExpediaKhách sạn Expedia Rapid API trong hệ thống đặt phòng của bạn
- Công cụ đặt phòng khách sạnĐặt phòng trực tiếp trên website khách sạn của bạn
- Khách sạnBedbank và hợp đồng trực tiếp
- Cổng du lịch B2BĐăng nhập đại lý, quy tắc giá, chứng từ và quyết toán
