Integrasi API hotel

Integrasi API RateHawk: daripada API key hingga tempahan hotel sebenar

Sambungkan akaun RateHawk anda ke PHPTRAVELS dan jual hotel serta apartmen RateHawk di laman web dan portal ejen anda sendiri. Penyambung sudah sedia: masukkan API key anda, import pangkalan data hotel, tetapkan markup dan lalui pensijilan RateHawk.

  • Penyambung RateHawk sedia ada
  • ETG API v3
  • Import dump hotel
  • Markup anda pada kadar bersih

Pembekal

Apakah RateHawk, dan mengapa agensi menyambungkannya

RateHawk ialah platform tempahan B2B Emerging Travel Group (ETG) untuk ejen pelancongan, pengendali pelancongan dan syarikat pelancongan. Rakan kongsi menempah hotel, apartmen dan penginapan lain pada kadar bersih, sama ada dalam portal RateHawk sendiri atau melalui API-nya.

API ini dipanggil ETG API. Versi semasanya ialah v3, iaitu REST API dengan permintaan dan respons JSON yang merangkumi carian, tempahan dan pembatalan. PHPTRAVELS menyediakan penyambung RateHawk dalam modul penginapan, jadi hasil RateHawk dipaparkan bersebelahan pembekal hotel lain dan kontrak anda sendiri.

Berkaitan:PenginapanEnjin tempahan hotelAPI pelancongan

Maklumat pembekal
Syarikat
RateHawk, sebahagian daripada Emerging Travel Group
Jenis
Platform penginapan B2B untuk profesional pelancongan
Inventori
Lebih 2.6 juta pilihan penginapan, menurut RateHawk
Rakan kongsi API
Lebih 700 pelanggan API, menurut RateHawk pada 2024
API
ETG API v3 · REST · JSON
Dalam PHPTRAVELS
Penyambung sedia ada dalam modul penginapan

Aliran tempahan ETG API v3

Bagaimana tempahan RateHawk berjalan, fasa demi fasa

Setiap tempahan RateHawk melalui lima fasa yang sama. Setiap fasa menyenaraikan panggilan ETG API di sebaliknya dan apa yang PHPTRAVELS lakukan untuk anda.

  1. 01

    Carian

    Panggilan ETG API

    Carian mengikut wilayah · koordinat geografi · ID hotel

    PHPTRAVELS

    Mencari mengikut bandar, kawasan peta atau senarai hotel, dengan tarikh, tetamu dan negara kediaman pengembara, lalu memaparkan kadar bersih langsung dengan markup anda.

  2. 02

    Halaman hotel

    Panggilan ETG API

    Dapatkan halaman hotel

    PHPTRAVELS

    Memuatkan setiap bilik dan kadar hotel yang dipilih: pakej makan, cukai, polisi pembatalan dan jenis bayaran.

  3. 03

    Pratempahan

    Panggilan ETG API

    Pratempah kadar · Dapatkan maklumat kadar

    PHPTRAVELS

    Menyemak bahawa kadar yang dipilih masih tersedia pada harga itu sejurus sebelum bayaran, dan menghentikan pembayaran jika ia berubah.

  4. 04

    Tempah

    Panggilan ETG API

    Cipta, mulakan dan semak proses tempahan

    PHPTRAVELS

    Mencipta tempahan, menghantar butiran tetamu, memantau status sehingga disahkan dan menyimpan ID pesanan RateHawk.

  5. 05

    Selepas tempahan

    Panggilan ETG API

    Dapatkan tempahan · Batalkan tempahan · Webhook status

    PHPTRAVELS

    Menghantar baucar, memaparkan tempahan dalam panel admin dan akaun pelanggan, serta menjalankan pembatalan mengikut polisi kadar tersebut.

Data statik

Import pangkalan data hotel RateHawk sekali, kemudian pastikan ia terkini

Hasil carian hanya membawa kadar. Nama, alamat, foto, kemudahan dan penerangan datang daripada data statik ETG, yang diimport oleh PHPTRAVELS ke halaman hotel anda.

  • Dump wilayah

    Negara, bandar dan kawasan, supaya pengembara boleh mencari mengikut destinasi.

  • Dump hotel

    Fail kandungan hotel lengkap: nama, alamat, koordinat, foto, kemudahan dan penerangan.

  • Dump tokokan

    Hanya perubahan sejak import terakhir, supaya katalog kekal terkini tanpa muat semula penuh.

  • Dump ulasan

    Skor dan teks ulasan tetamu untuk dipaparkan di halaman hotel, jika perjanjian anda merangkuminya.

Import kandungan hotel
  • Dump wilayah100%
  • Dump hotel100%
  • Dump tokokan64%
  • Dump ulasan30%

Skrin contoh. Bilangan bergantung pada akaun dan bahasa anda.

Selain fail dump, ETG juga menawarkan Content API untuk data hotel atas permintaan.

API key dan sandbox

Cara pengesahan API RateHawk berfungsi

ETG API menggunakan pengesahan HTTP Basic. Key ID anda ialah nama pengguna dan API key anda ialah kata laluan, dihantar melalui HTTPS bersama setiap permintaan.

Permintaan carian sandbox (contoh)
 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
Dua hos
Sandbox: api-sandbox.ratehawk.com. Ujian dan produksi: api.ratehawk.com. Hos worldota.net yang lama sudah tidak digunakan lagi.
Hotel ujian adalah sebenar
Kunci ujian hanya boleh menempah hotel ujian dengan hid 8473727, dan tempahan itu adalah sebenar, dengan tanggungjawab kewangan sebenar. Batalkannya sejurus selepas ujian.
Kunci kekal di pelayan
PHPTRAVELS menyimpan key ID dan API key dalam konfigurasi pelayan, tidak sekali-kali dalam pelayar atau aplikasi.
Negara kediaman penting
Kadar bergantung pada negara kediaman pengembara, jadi penyambung menghantarnya bersama setiap carian.

Persediaan dalam PHPTRAVELS

Sediakan penyambung RateHawk dalam empat langkah

Tiada kod untuk ditulis: penyambung dikonfigurasi dalam panel admin.

  1. 01Masukkan API key andaTampal key ID dan API key daripada RateHawk, mula-mula untuk sandbox, kemudian untuk produksi.
  2. 02Import pangkalan data hotelMuatkan dump wilayah dan dump hotel, kemudian jadualkan kemas kini tokokan.
  3. 03Tetapkan markup dan mata wangMarkup peratusan atau tetap, mengikut saluran, kumpulan ejen atau destinasi, dalam mata wang yang anda jual.
  4. 04Uji dan mula beroperasiJalankan tempahan dan pembatalan ujian, lulus pensijilan, kemudian tukar kepada kunci produksi.
Pembekal › RateHawkRateHawk

Persekitaran

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

Key ID4127
API key••••••••••••••••
Markup12% pada kadar bersih
Mata wangUSD · EUR · GBP
Negara kediaman lalaiGB

Skrin tetapan contoh.

Pensijilan

Daripada perjanjian hingga akses produksi

RateHawk hanya membuka produksi selepas perjanjian ditandatangani dan integrasi anda lulus pensijilannya.

  1. 1

    Tandatangani perjanjian API

    Anda

    Hubungi RateHawk sebagai syarikat pelancongan dan tandatangani perjanjian API untuk pasaran anda.

  2. 2

    Terima kunci sandbox

    RateHawk

    RateHawk mengeluarkan key ID dan API key untuk sandbox.

  3. 3

    Sambung dan import

    PHPTRAVELS

    Kunci dimasukkan ke dalam PHPTRAVELS, data statik diimport dan markup ditetapkan.

  4. 4

    Lulus pensijilan

    RateHawk

    RateHawk menyemak integrasi, termasuk aliran tempahan, status dan pembatalan.

  5. 5

    Akses produksi

    Anda

    Kunci produksi dimasukkan ke dalam panel admin dan tempahan sebenar bermula.

Portal, API atau enjin

Tiga cara menjual hotel RateHawk

Ejen boleh menempah di laman web RateHawk sendiri hari ini. API, di dalam enjin tempahan anda sendiri, ialah apa yang meletakkan hotel RateHawk di bawah jenama anda.

  • Laman web RateHawk

    Siapa menempah
    Ejen anda, satu tempahan pada satu masa
    Jenama siapa
    RateHawk
    Apa yang diperlukan
    Daftar sebagai ejen dan log masuk
  • Bina API anda sendiri

    Siapa menempah
    Pelanggan dan ejen anda, dalam talian
    Jenama siapa
    Anda
    Apa yang diperlukan
    Berbulan-bulan pembangunan dan pensijilan
  • PHPTRAVELS dengan RateHawk

    Siapa menempah
    Pelanggan dan ejen anda, dalam talian
    Jenama siapa
    Anda
    Apa yang diperlukan
    Konfigurasi, import kandungan dan pensijilan

Pelbagai pembekal

RateHawk bersebelahan pembekal hotel anda yang lain

RateHawk ialah satu pembekal dalam modul penginapan. Carian yang sama boleh merangkumi API hotel anda yang lain dan kontrak anda sendiri, dengan markup dan penghalaan bagi setiap pembekal.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds

Baca panduan ejen

Soalan lazim

Soalan tentang integrasi API RateHawk

Apa yang ditanya agensi sebelum menyambungkan RateHawk.

Hubungi jualan

RateHawk tidak menerbitkan yuran untuk akses API. Anda menandatangani perjanjian API dan menjual hotelnya pada kadar bersih dengan markup anda sendiri. Kos anda ialah perisian tempahan, pengehosan dan pembayaran.

Hubungi RateHawk sebagai syarikat pelancongan dan tandatangani perjanjian API. RateHawk kemudian mengeluarkan key ID dan API key untuk sandbox, dan kunci produksi selepas pensijilan.

Dokumentasi ETG API tersedia dalam talian di docs.emergingtravel.com, dengan B2B API, Content API, panduan sandbox dan pensijilan. Tiada PDF berasingan untuk dimuat turun; dokumentasi dalam talian ialah versi semasa.

ETG API ialah API Emerging Travel Group, syarikat di sebalik RateHawk. Integrasi API RateHawk dan integrasi ETG API membawa maksud yang sama; versi semasa ialah v3.

PHPTRAVELS ialah lesen sekali bayar bermula USD 2,499 dengan kod sumber penuh, dan penyambung RateHawk disertakan dalam modul penginapan. Terma komersial RateHawk anda dipersetujui terus dengan RateHawk.

Ya, di api-sandbox.ratehawk.com. Ambil perhatian bahawa kunci ujian hanya boleh menempah hotel ujian dengan hid 8473727, dan tempahan itu adalah sebenar, jadi batalkannya sejurus selepas ujian.

Ejen mendaftar dan log masuk di ratehawk.com untuk menempah dalam portal. Akses API adalah berasingan: ia menggunakan key ID dan API key daripada perjanjian anda, bukan log masuk portal anda.

Penyambung sudah wujud, jadi masa digunakan untuk perjanjian, memasukkan kunci, mengimport kandungan hotel dan pensijilan RateHawk, bukannya pembangunan.

Ya. Penyambung yang sama melayani laman web B2C dan portal ejen B2B anda, dengan markup berasingan bagi setiap saluran dan kumpulan ejen.

Setiap kadar membawa polisi pembatalannya, yang dipaparkan sebelum bayaran. Pembatalan dijalankan dari panel admin atau akaun pelanggan melalui panggilan batalkan tempahan, mengikut polisi tersebut.