Otel API entegrasyonu

RateHawk API entegrasyonu: API anahtarından canlı otel rezervasyonlarına

RateHawk hesabınızı PHPTRAVELS'a bağlayın ve RateHawk otellerini ve apartlarını kendi web sitenizde ve acente portalınızda satın. Bağlayıcı hazır: API anahtarlarınızı ekleyin, otel veritabanını içe aktarın, kâr marjınızı belirleyin ve RateHawk sertifikasyonundan geçin.

  • Hazır RateHawk bağlayıcısı
  • ETG API v3
  • Otel dump içe aktarma
  • Net fiyatlara kendi kâr marjınız

Tedarikçi

RateHawk nedir ve acenteler neden bağlar

RateHawk, Emerging Travel Group'un (ETG) seyahat acenteleri, tur operatörleri ve seyahat şirketleri için B2B rezervasyon platformudur. İş ortakları otelleri, apartları ve diğer konaklama seçeneklerini net fiyatlarla, RateHawk'ın kendi portalında veya API'si üzerinden rezerve eder.

Bu API'nin adı ETG API'dir. Güncel sürümü v3'tür: arama, rezervasyon ve iptali kapsayan, JSON istek ve yanıtlarla çalışan bir REST API. PHPTRAVELS, konaklama modülünde hazır bir RateHawk bağlayıcısı sunar; böylece RateHawk sonuçları diğer otel tedarikçilerinizin ve kendi kontratlarınızın yanında görünür.

İlgili:KonaklamaOtel rezervasyon motoruSeyahat API'leri

Tedarikçi bilgi kartı
Şirket
RateHawk, Emerging Travel Group bünyesinde
Tür
Turizm profesyonelleri için B2B konaklama platformu
Envanter
RateHawk'ın belirttiğine göre 2,6 milyondan fazla konaklama seçeneği
API iş ortakları
RateHawk'ın 2024'te belirttiğine göre 700'den fazla API müşterisi
API
ETG API v3 · REST · JSON
PHPTRAVELS'ta
Konaklama modülünde hazır bağlayıcı

ETG API v3 rezervasyon akışı

Bir RateHawk rezervasyonu adım adım nasıl ilerler

Her RateHawk rezervasyonu aynı beş aşamadan geçer. Her aşamada arkasındaki ETG API çağrıları ve PHPTRAVELS'ın sizin için yaptıkları yer alır.

  1. 01

    Arama

    ETG API çağrıları

    Bölgeye göre · coğrafi koordinatlara göre · otel ID'lerine göre arama

    PHPTRAVELS

    Şehir, harita alanı veya otel listesine göre; tarihler, misafirler ve yolcunun ikamet ülkesiyle arama yapar ve kâr marjınız eklenmiş canlı net fiyatları gösterir.

  2. 02

    Otel sayfası

    ETG API çağrıları

    Retrieve hotelpage

    PHPTRAVELS

    Seçilen otelin tüm oda ve fiyatlarını yükler: pansiyon tipi, vergiler, iptal koşulları ve ödeme türü.

  3. 03

    Ön rezervasyon

    ETG API çağrıları

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Ödemeden hemen önce seçilen fiyatın o tutarla hâlâ müsait olduğunu kontrol eder ve fiyat değiştiyse ödeme sürecini durdurur.

  4. 04

    Rezervasyon

    ETG API çağrıları

    Rezervasyon sürecini oluşturma, başlatma ve kontrol etme

    PHPTRAVELS

    Rezervasyonu oluşturur, misafir bilgilerini gönderir, onaylanana kadar durumu takip eder ve RateHawk sipariş ID'sini kaydeder.

  5. 05

    Rezervasyon sonrası

    ETG API çağrıları

    Retrieve bookings · Cancel booking · Durum webhook'ları

    PHPTRAVELS

    Voucher'ı gönderir, rezervasyonu yönetim panelinde ve müşteri hesabında gösterir, iptalleri fiyatın koşullarına göre yürütür.

Statik veri

RateHawk otel veritabanını bir kez içe aktarın, sonra güncel tutun

Arama sonuçları yalnızca fiyatları içerir. İsimler, adresler, fotoğraflar, olanaklar ve açıklamalar ETG'nin statik verilerinden gelir; PHPTRAVELS bunları otel sayfalarınıza aktarır.

  • Bölge dump'ı

    Ülkeler, şehirler ve bölgeler; böylece yolcular destinasyona göre arama yapabilir.

  • Otel dump'ı

    Eksiksiz otel içerik dosyası: isimler, adresler, koordinatlar, fotoğraflar, olanaklar ve açıklamalar.

  • Artımlı dump

    Yalnızca son içe aktarmadan bu yana değişenler; katalog tam yeniden yükleme olmadan güncel kalır.

  • Yorum dump'ı

    Sözleşmeniz kapsıyorsa otel sayfalarında gösterilecek misafir yorum puanları ve metinleri.

Otel içeriği içe aktarma
  • Bölge dump'ı100%
  • Otel dump'ı100%
  • Artımlı dump64%
  • Yorum dump'ı30%

Örnek ekran. Sayılar hesabınıza ve dillerinize bağlıdır.

ETG, dump dosyalarının yanı sıra talep üzerine otel verisi için bir Content API de sunar.

API anahtarı ve sandbox

RateHawk API kimlik doğrulaması nasıl çalışır

ETG API, HTTP Basic kimlik doğrulaması kullanır. Key ID'niz kullanıcı adı, API anahtarınız ise paroladır; her istekle birlikte HTTPS üzerinden gönderilir.

Sandbox arama isteği (örnek)
 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
İki host
Sandbox: api-sandbox.ratehawk.com. Test ve canlı ortam: api.ratehawk.com. Eski worldota.net hostları kullanımdan kaldırılmıştır.
Test oteli gerçektir
Test anahtarlarıyla yalnızca hid 8473727 numaralı test oteli rezerve edilebilir ve bu rezervasyon gerçektir, gerçek mali sorumluluk doğurur. Testten hemen sonra iptal edin.
Anahtarlar sunucuda kalır
PHPTRAVELS, key ID'yi ve API anahtarını tarayıcıda veya uygulamada değil, sunucu yapılandırmasında saklar.
İkamet ülkesi önemlidir
Fiyatlar yolcunun ikamet ülkesine bağlıdır, bu nedenle bağlayıcı bunu her aramada gönderir.

PHPTRAVELS'ta kurulum

RateHawk bağlayıcısını dört adımda kurun

Kod yazmanıza gerek yok: bağlayıcı yönetim panelinden yapılandırılır.

  1. 01API anahtarlarınızı ekleyinRateHawk'tan aldığınız key ID ve API anahtarını önce sandbox, ardından canlı ortam için yapıştırın.
  2. 02Otel veritabanını içe aktarınBölge ve otel dump'larını yükleyin, ardından artımlı güncellemeleri zamanlayın.
  3. 03Kâr marjı ve para birimini belirleyinKanal, acente grubu veya destinasyona göre, sattığınız para birimlerinde yüzde ya da sabit kâr marjları.
  4. 04Test edin ve canlıya geçinTest rezervasyonunu ve iptalini yapın, sertifikasyonu geçin, ardından canlı anahtarlara geçin.
Tedarikçiler › RateHawkRateHawk

Ortam

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

Key ID4127
API anahtarı••••••••••••••••
Kâr marjıNet fiyatlara %12
Para birimiUSD · EUR · GBP
Varsayılan ikamet ülkesiGB

Örnek ayarlar ekranı.

Sertifikasyon

Sözleşmeden canlı ortam erişimine

RateHawk canlı ortamı ancak sözleşme imzalandıktan ve entegrasyonunuz sertifikasyonu geçtikten sonra açar.

  1. 1

    API sözleşmesini imzalayın

    Siz

    Bir seyahat şirketi olarak RateHawk ile iletişime geçin ve pazarlarınız için API sözleşmesini imzalayın.

  2. 2

    Sandbox anahtarlarını alın

    RateHawk

    RateHawk, sandbox için bir key ID ve API anahtarı verir.

  3. 3

    Bağlayın ve içe aktarın

    PHPTRAVELS

    Anahtarlar PHPTRAVELS'a girilir, statik veriler içe aktarılır ve kâr marjları belirlenir.

  4. 4

    Sertifikasyonu geçin

    RateHawk

    RateHawk, rezervasyon, durum ve iptal akışı dahil entegrasyonu kontrol eder.

  5. 5

    Canlı ortam erişimi

    Siz

    Canlı anahtarlar yönetim paneline girilir ve gerçek rezervasyonlar başlar.

Portal, API veya motor

RateHawk otellerini satmanın üç yolu

Acenteler bugün RateHawk'ın kendi web sitesinden rezervasyon yapabilir. RateHawk otellerini sizin markanızla sunan ise kendi rezervasyon motorunuzun içindeki API'dir.

  • RateHawk web sitesi

    Kim rezervasyon yapar
    Acenteleriniz, her seferinde tek rezervasyon
    Kimin markası
    RateHawk
    Ne gerektirir
    Acente olarak kaydolup giriş yapmak
  • Kendi API geliştirmeniz

    Kim rezervasyon yapar
    Müşterileriniz ve acenteleriniz, online
    Kimin markası
    Sizin
    Ne gerektirir
    Aylarca geliştirme ve sertifikasyon
  • RateHawk ile PHPTRAVELS

    Kim rezervasyon yapar
    Müşterileriniz ve acenteleriniz, online
    Kimin markası
    Sizin
    Ne gerektirir
    Yapılandırma, içerik aktarımı ve sertifikasyon

Çoklu tedarikçi

Diğer otel tedarikçilerinizin yanında RateHawk

RateHawk, konaklama modülündeki tedarikçilerden biridir. Aynı arama, tedarikçi bazında kâr marjı ve yönlendirmeyle diğer otel API'lerinizi ve kendi kontratlarınızı da kapsayabilir.

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

Acente rehberini okuyun

SSS

RateHawk API entegrasyonu hakkında sorular

Acentelerin RateHawk'ı bağlamadan önce sordukları.

Satış ekibiyle görüşün

RateHawk, API erişimi için bir ücret yayımlamaz. Bir API sözleşmesi imzalarsınız ve otellerini kendi kâr marjınızla net fiyatlar üzerinden satarsınız. Maliyetleriniz rezervasyon yazılımınız, barındırma ve ödemelerdir.

Bir seyahat şirketi olarak RateHawk ile iletişime geçin ve API sözleşmesini imzalayın. RateHawk ardından sandbox için bir key ID ve API anahtarı, sertifikasyondan sonra da canlı anahtarları verir.

ETG API dokümantasyonu docs.emergingtravel.com adresinde online olarak bulunur; B2B API, Content API, sandbox ve sertifikasyon rehberlerini içerir. İndirilecek ayrı bir PDF yoktur; güncel sürüm online dokümantasyondur.

ETG API, RateHawk'ın arkasındaki şirket olan Emerging Travel Group'un API'sidir. RateHawk API entegrasyonu ile ETG API entegrasyonu aynı şeydir; güncel sürüm v3'tür.

PHPTRAVELS, tam kaynak koduyla birlikte $2.499 fiyatından başlayan tek seferlik bir lisanstır ve RateHawk bağlayıcısı konaklama modülüne dahildir. RateHawk ticari koşullarınızı RateHawk ile kararlaştırırsınız.

Evet, api-sandbox.ratehawk.com adresinde. Test anahtarlarıyla yalnızca hid 8473727 numaralı test otelinin rezerve edilebildiğini ve bu rezervasyonun gerçek olduğunu unutmayın; testten hemen sonra iptal edin.

Acenteler portalda rezervasyon yapmak için ratehawk.com'a kaydolur ve giriş yapar. API erişimi ayrıdır: portal girişinizi değil, sözleşmenizdeki key ID ve API anahtarını kullanır.

Bağlayıcı zaten mevcut olduğundan süre geliştirmeye değil; sözleşmeye, anahtarların eklenmesine, otel içeriğinin aktarılmasına ve RateHawk sertifikasyonuna gider.

Evet. Aynı bağlayıcı, kanal ve acente grubu bazında ayrı kâr marjlarıyla hem B2C web sitenize hem de B2B acente portalınıza hizmet verir.

Her fiyatın, ödemeden önce gösterilen kendi iptal koşulları vardır. İptaller, bu koşullara göre rezervasyon iptal çağrısı aracılığıyla yönetim panelinden veya müşteri hesabından yapılır.