B2Bed API & Geliştirici Dokümantasyonu

ElektraWeb PMS canlı bağlantılı otel portföyümüze programatik olarak bağlanın. Kendi web sitenizden, mobil uygulamanızdan veya ERP sisteminizden anlık fiyat & kontenjan sorgulayın, doğrudan rezervasyon oluşturun.

Hızlı Canlı API Test Konsolu (Sandbox)

Acenta panelinizden ürettiğiniz b2b_live_... veya b2b_test_... API anahtarınızı girip bağlantıyı anında test edin:

Sunucu Yanıtı:

Kimlik Doğrulama (Authentication)

Tüm M2M isteklerinde HTTP başlığı (header) olarak acentanıza tanımlı API anahtarını iletmeniz gerekmektedir. İki yöntem desteklenir:

HTTP Headers

x-api-key: b2b_live_8f93e2b104928f01...
# VEYA
Authorization: Bearer b2b_live_8f93e2b104928f01...

JSON ve XML Çıktı Desteği

Sistemimiz varsayılan olarak modern application/json yanıtı verir. Eski tur operatörü veya küresel seyahat yazılımlarınız için Accept: application/xml başlığı ya da ?format=xml sorgusuyla tam uyumlu XML çıktısı alabilirsiniz.

GET /api/v1/distribution/hotels

Acentanızın yetkili olduğu otelleri ve temel bilgileri listeler.

cURL Örneği

curl -X GET "https://portal.b2bed.com.tr/api/v1/distribution/hotels" \
  -H "x-api-key: YOUR_API_KEY"

POST /api/v1/distribution/availability

Belirtilen tarihler ve kişi sayısı için ElektraWeb PMS'ten anlık kontenjan ve net B2B fiyatlarını çeker. Acentanıza tanımlı kâr marjı (markup) varsa satış fiyatı otomatik hesaplanır.

Parametre	Tip	Zorunlu	Açıklama
checkIn	string	Zorunlu	Giriş Tarihi (YYYY-AA-GG)
checkOut	string	Zorunlu	Çıkış Tarihi (YYYY-AA-GG)
adults	integer	İsteğe Bağlı	Yetişkin Sayısı (Varsayılan: 2)
children	integer	İsteğe Bağlı	Çocuk Sayısı (Varsayılan: 0)
hotelId	string	İsteğe Bağlı	Belirli bir otel ID'si veya kodu

JSON İstek Gövdesi (Payload)

{
  "checkIn": "2026-10-15",
  "checkOut": "2026-10-18",
  "adults": 2,
  "children": 0,
  "hotelId": "hotel-id",
  "boardTypeCode": "BB"
}

POST /api/v1/distribution/bookings

ElektraWeb PMS üzerinde anında kesinleşmiş rezervasyon açar, acenta cari limitinden düşer ve resmi Voucher numarası üretir.

JSON Rezervasyon İsteği

{
  "hotelId": "hotel-id",
  "checkIn": "2026-10-15",
  "checkOut": "2026-10-18",
  "roomId": "room-deluxe",
  "boardCode": "BB",
  "adults": 2,
  "children": 0,
  "clientReference": "MY_OTA_REF_10293",
  "paymentMethod": "AGENCY_CREDIT",
  "leadGuest": {
    "firstName": "Ahmet",
    "lastName": "Yılmaz",
    "phone": "+905321112233",
    "email": "[email protected]"
  },
  "notes": "Balayı çifti, yüksek kat oda rica ediliyor."
}

White-Label (B2B2C) Web Sitesi & iframe Entegrasyonu

Yazılımcı gerektirmeden, acenta panelinizden 2 dakikada kendi B2C rezervasyon motorunuzu aktif edin.

Örneğin acenta adınız Güneş Turizm ve slug'ınız gunestur ise:

Doğrudan Web Sitesi Linki

https://portal.b2bed.com.tr/whitelabel/gunestur

Kendi WordPress, Wix veya kurumsal sitenizin içine gömmek için tek satırlık iframe kodu:

iframe Gömme Kodu

<iframe src="https://portal.b2bed.com.tr/whitelabel/embed/gunestur" 
        width="100%" 
        height="850" 
        frameborder="0" 
        style="border:none; border-radius:14px; box-shadow:0 8px 30px rgba(0,0,0,0.08);">
</iframe>