Tích hợp nhà cung cấp khách sạn
Tích hợp Hotelbeds API: nội dung, ánh xạ và đặt phòng trực tiếp
Tích hợp Hotelbeds API gồm hai việc, không phải một. Bạn tải và lưu trữ nội dung khách sạn, sau đó đặt phòng theo giá trực tiếp. PHPTRAVELS thực hiện cả hai trong mô-đun khách sạn, với hợp đồng và khóa Hotelbeds của chính bạn.
- Đồng bộ Content API
- Luồng Booking API
- Giá BOOKABLE và RECHECK
- Ánh xạ khách sạn
Các API của Hotelbeds phối hợp ra sao
Tích hợp Hotelbeds API: một bên là nội dung, một bên là đặt phòng
Hotelbeds chia API khách sạn thành hai phần. Content API trả về dữ liệu tĩnh: mô tả, hình ảnh, tiện nghi, gói ăn và loại phòng. Booking API trả về phòng trống và giá trực tiếp, đồng thời nhận đặt phòng. Chọn một bước ở giữa để xem bước đó dùng những lệnh gọi nào.
Content API
Tĩnh, lưu trữ ở phía bạn- Danh sách khách sạn
hotels · from=1&to=1000Mọi khách sạn trong danh mục của bạn, theo trang tối đa 1,000 khách sạn mỗi yêu cầu. - Tiện nghi, gói ăn và loại phòng
facilities · boards · roomsCác bảng mã chuyển mã của Booking API thành từ ngữ mà khách hiểu được. - Hình ảnh
photos.hotelbeds.com/giata/Đường dẫn ảnh một phần, ghép với máy chủ ảnh của Hotelbeds theo kích thước bạn cần. - Thay đổi hằng ngày
lastUpdateTimeSau lần tải đầu tiên, mỗi ngày một yêu cầu kèm lastUpdateTime chỉ trả về những gì đã thay đổi.
Luồng yêu cầu
Booking API
Trực tiếp, gọi theo từng khách- Tra phòng trống
POST /hotelsPhòng, gói ăn, giá và phí hủy theo mã khách sạn, ngày và số người của bạn. - Kiểm tra giá
POST /checkratesGiá và điều kiện cập nhật cho mức giá được đánh dấu RECHECK, cùng các lựa chọn nâng hạng. - Đặt phòng
POST /bookingsXác nhận rateKey đã chọn với tên người đặt và tên khách, rồi trả về mã đặt phòng. - Hủy phòng
DELETE /bookings · simulateMô phỏng việc hủy để hiển thị phí, hoặc hủy đặt phòng thật.
Phần lớn dự án Hotelbeds thất bại vì trộn lẫn hai phần này. Họ gọi Content API trong lúc khách tìm kiếm, vốn chậm và, như Hotelbeds cảnh báo, có thể khiến thông tin xác thực bị chặn. Hoặc họ tìm kiếm trực tiếp mà không có mã đã lưu nên không hiển thị được hình ảnh hay tiện nghi. PHPTRAVELS tách riêng hai phần: nội dung được đồng bộ ở nền, và chỉ các lệnh tra phòng trống, kiểm tra giá và đặt phòng chạy khi khách đang chờ.
Nếu bạn muốn tìm hiểu về chính nhà cung cấp, sản phẩm của họ và cách mở tài khoản, hãy đọc hồ sơ nhà cung cấp Hotelbeds. Trang này nói về tích hợp kỹ thuật.
Loại giá
Bốn trường giá làm thay đổi quy trình thanh toán
Mỗi mức giá của Hotelbeds có một vài thuộc tính quyết định bạn có thể đặt ngay hay không, được hiển thị giá nào và ai là người thu tiền. Đây là những trường mà hệ thống của bạn phải đọc trên mọi kết quả.
| Trường | Trường hợp thứ nhất | Trường hợp thứ hai | PHPTRAVELS xử lý thế nào |
|---|---|---|---|
Đặt ngay hay cần kiểm tra lạirateType | BOOKABLEGiá đã cập nhật. Bạn có thể đặt mà không cần gọi thêm. | RECHECKBạn phải gọi kiểm tra giá trước để lấy giá và điều kiện mới nhất. | Chạy kiểm tra giá trước bước thanh toán với giá RECHECK và hiển thị mọi thay đổi cho khách. |
Giá net hay giá hoa hồngnet · sellingRate | netMô hình net: giá là giá net, bạn tự cộng lợi nhuận. | sellingRateMô hình hoa hồng: hoa hồng đã nằm trong sellingRate, và đó là giá cuối cùng. | Áp dụng quy tắc tăng giá của bạn cho giá net và bán giá hoa hồng theo sellingRate. |
Giá bán cố địnhhotelMandatory | truehotelMandatory là true: bạn phải bán theo sellingRate. | false · nullFalse hoặc trống trên giá net: bạn có thể tự đặt lợi nhuận. | Khóa giá hiển thị ở sellingRate khi khách sạn yêu cầu, bất kể quy tắc tăng giá. |
Khi nào khách thanh toánpaymentType | AT_WEBThanh toán khi đặt phòng, qua website của bạn. | AT_HOTELKhách thanh toán trực tiếp cho khách sạn. | Gắn nhãn giá là trả ngay hoặc trả tại khách sạn, và điều hướng thanh toán cho phù hợp. |
Mô hình giá bạn nhận được tùy thuộc vào hợp đồng Hotelbeds của bạn. Theo Hotelbeds, quản lý bán hàng sẽ đề xuất mô hình phù hợp với doanh nghiệp của bạn.
Ánh xạ khách sạn
Ghép khách sạn Hotelbeds với những khách sạn bạn đang bán
Nếu bạn có hợp đồng riêng hoặc nhà cung cấp thứ hai, cùng một khách sạn sẽ đến với các mã khác nhau. Ánh xạ liên kết chúng lại, để khách thấy một khách sạn với giá tốt nhất thay vì ba bản trùng.
Ánh xạ hoạt động thế nào trong PHPTRAVELS
Sau mỗi lần đồng bộ nội dung, PHPTRAVELS so sánh khách sạn Hotelbeds với danh sách khách sạn của bạn theo tên, địa chỉ, thành phố và tọa độ. Các cặp gần khớp được liên kết tự động. Những cặp chưa chắc chắn chờ người xác nhận, còn khách sạn không có cặp có thể được nhập thành cơ sở lưu trú mới hoặc bỏ qua.
Khách sạn đã ánh xạ dùng chung một trang, một thư viện ảnh và một điểm đánh giá trong Khách sạn, trong khi mỗi nhà cung cấp giữ giá và quy tắc riêng. Cùng một bản ánh xạ được dùng cho website công khai và Cổng du lịch B2B của bạn.
- Harbour View HotelLisbon48291397%Đã khớp
- Old Town SuitesPraha11735492%Đã khớp
- Palm Court ResortDubai66201874%Xem xét
- Casa Azul BoutiqueSevilla–0%Không khớp
- Northern Lights LodgeTromsø90522766%Xem xét
- Riverside ApartmentsBudapest33076198%Đã khớp
Màn hình mẫu với khách sạn và mã giả định.
Hotelbeds XML hay JSON
Mọi yêu cầu đều được ký, và thử nghiệm bắt đầu từ quy mô nhỏ
Nhiều nhóm vẫn tìm kiếm Hotelbeds XML, nhưng tài liệu hiện tại trình bày yêu cầu JSON. Dù thế nào cũng là cùng một bộ thao tác, và mỗi yêu cầu mang hai header.
1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6 -H "Api-key: $API_KEY" \ 7 -H "X-Signature: $SIG" \ 8 -H "Accept: application/json" \ 9 -H "Content-Type: application/json" \10 -d '{11 "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12 "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13 "hotels": { "hotel": [482913, 117354] }14 }'1516# hotel codes come from your stored Content API data, never a live content call
- Hai header
- Api-key chứa khóa của bạn, và X-Signature: mã băm SHA256 của khóa, secret và thời gian hiện tại tính bằng giây.
- Máy chủ thử nghiệm
- Theo Hotelbeds, máy chủ thử nghiệm giống môi trường thật, nhưng các đặt phòng ở đó không có thật và thẻ không bị trừ tiền.
- 50 yêu cầu mỗi ngày
- Khóa mới mở môi trường đánh giá với hạn mức 50 yêu cầu mỗi ngày. Hạn mức tăng sau khi được chứng nhận.
- Không gọi nội dung trực tiếp
- Hotelbeds cảnh báo rằng gọi Content API theo thời gian thực có thể khiến thông tin xác thực bị chặn. PHPTRAVELS không bao giờ làm vậy.
Công cụ lập kế hoạch đồng bộ nội dung
Danh sách khách sạn của bạn cần bao nhiêu lệnh gọi Content API
Theo Hotelbeds, danh sách khách sạn được trả về theo trang tối đa 1,000 khách sạn, và sau lần tải đầu tiên, một yêu cầu lastUpdateTime mỗi ngày chỉ trả về các thay đổi. Nhập số liệu của bạn để lập kế hoạch đồng bộ.
- Số yêu cầu cho lần tải đầy đủ đầu tiên
- 20
- Số yêu cầu cho mỗi lần cập nhật hằng ngày
- 3
- Số ngày để tải một lần với hạn mức đánh giá
- 1
Chỉ là ước tính cho danh sách khách sạn. Bảng mã và hình ảnh sẽ thêm một vài lệnh gọi. Với hạn mức đánh giá 50 yêu cầu mỗi ngày, hãy thử với một điểm đến trước.
Danh sách kiểm tra trước khi vận hành
Những gì cần chuẩn bị trước khi chuyển sang môi trường thật
Hotelbeds đưa bạn từ giai đoạn đánh giá sang chứng nhận rồi đến khóa thật thông qua bảng điều khiển. Đây là những điểm mà một tích hợp Hotelbeds API cần đáp ứng trước, và cách PHPTRAVELS đáp ứng.
- Đã thêm khóa đánh giá trong trang quản trị, chọn máy chủ thử nghiệm
- Content API đã đồng bộ vào cơ sở dữ liệu, có lịch cập nhật hằng ngày
- Khách sạn đã ánh xạ với danh sách của bạn, các cặp chưa chắc đã được xem xét
- Giá RECHECK đi qua kiểm tra giá trước khi thanh toán
- Tuân thủ sellingRate khi hotelMandatory là true
- Hiển thị ghi chú giá và phí hủy trước khi khách thanh toán
- Voucher hiển thị mã đặt phòng Hotelbeds và ghi chú giá
- Mô phỏng hủy trước, sau đó xác nhận, có ghi lại phí
Các bước chứng nhận và quyền truy cập môi trường thật do Hotelbeds quy định theo hợp đồng và thị trường của bạn.
Chi phí
Một giấy phép cho hệ thống, hợp đồng riêng của bạn với Hotelbeds
PHPTRAVELS là giấy phép trả một lần kèm mã nguồn. Hotelbeds là thỏa thuận riêng giữa bạn và Hotelbeds, nên giá net và khóa vẫn thuộc về bạn.
Hotelbeds là một trong nhiều nguồn khách sạn bạn có thể chạy song song. Xem cách nó kết hợp với RateHawk trong phần tổng quan API du lịch, hoặc so sánh các nhà cung cấp trong danh sách nhà cung cấp XML.
Câu hỏi thường gặp
Câu hỏi về tích hợp Hotelbeds API
Những điều mà lập trình viên và doanh nghiệp du lịch hỏi trước khi kết nối Hotelbeds.
Liên hệ kinh doanhGồm hai phần. Một là đồng bộ nền với Content API để lưu khách sạn, hình ảnh, tiện nghi, gói ăn và loại phòng vào cơ sở dữ liệu của bạn. Hai là luồng trực tiếp với Booking API cho tra phòng trống, kiểm tra giá, đặt phòng và hủy phòng. PHPTRAVELS chạy cả hai trong mô-đun khách sạn.
Mọi người vẫn gọi là Hotelbeds XML, nhưng tài liệu Hotelbeds hiện tại trình bày yêu cầu và phản hồi JSON. Các thao tác vẫn như nhau, và PHPTRAVELS xử lý định dạng thay bạn.
Giá BOOKABLE đã cập nhật và có thể đặt ngay. Giá RECHECK cần gọi kiểm tra giá trước, lệnh này trả về giá và điều kiện hiện tại. PHPTRAVELS thực hiện lệnh gọi đó trước bước thanh toán.
Vì chậm, và Hotelbeds cảnh báo rằng dùng Content API theo thời gian thực có thể dẫn đến việc thông tin xác thực bị chặn. Nội dung nên được tải theo trang, lưu trữ và cập nhật mỗi ngày một lần bằng lastUpdateTime, đúng như cách PHPTRAVELS hoạt động.
Có. Bạn đăng ký với Hotelbeds, ký hợp đồng và nhận API key cùng secret của riêng bạn. Khóa mới hoạt động trên môi trường đánh giá với 50 yêu cầu mỗi ngày cho đến khi bạn hoàn tất chứng nhận.
Có. Ánh xạ khách sạn liên kết cùng một cơ sở lưu trú giữa các nguồn, để khách thấy một khách sạn với giá tốt nhất hiện có, trong khi mỗi nguồn giữ mức tăng giá và quy tắc riêng.
Các gói PHPTRAVELS bắt đầu từ với giấy phép trả một lần kèm mã nguồn. Hợp đồng Hotelbeds của bạn là riêng và được thỏa thuận trực tiếp với Hotelbeds. Hãy xem trang bảng giá hoặc liên hệ bộ phận bán hàng để nhận báo giá.
Khám phá thêm
Thêm về nền tảng
- API khách sạnAPI bedbank, OTA, GDS và khách sạn kết nối trực tiếp được giải thích
- Hồ sơ nhà cung cấp HotelbedsHotelbeds là ai và cách kết nối với PHPTRAVELS
- Tích hợp BedsonlineKhách sạn và giá đại lý Bedsonline trong hệ thố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
- Tích hợp API RateHawkKhách sạn RateHawk trong hệ thống đặt phòng, connector có sẵn