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.

Liên quan:Khách sạnCông cụ đặt phòng khách sạnAPI du lịch

Thông tin nhà cung cấp
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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Nhập nội dung khách sạn
  • 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.

Request tìm kiếm trên sandbox (mẫu)
 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
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ị.

  1. 01Thêm API keyDán key ID và API key từ RateHawk, trước tiên cho sandbox, sau đó cho production.
  2. 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.
  3. 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.
  4. 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.
Nhà cung cấp › RateHawkRateHawk

Môi trường

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

Key ID4127
API key••••••••••••••••
Markup12% trên giá net
Tiền tệUSD · EUR · GBP
Nơi cư trú mặc địnhGB

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. 1

    Ký thỏa thuận API

    Bạn

    Liê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. 2

    Nhận key sandbox

    RateHawk

    RateHawk cấp key ID và API key cho sandbox.

  3. 3

    Kết nối và nhập dữ liệu

    PHPTRAVELS

    Key được nhập vào PHPTRAVELS, dữ liệu tĩnh được nhập và markup được thiết lập.

  4. 4

    Vượt qua chứng nhận

    RateHawk

    RateHawk 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. 5

    Quyền truy cập production

    Bạn

    Key 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 hướng dẫn cho đại lý

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 doanh

RateHawk 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 đó.