Geliştirici API
Bedoka envanterini, fiyat ve müsaitlik verisini ve rezervasyon olaylarını kendi sisteminize bağlayın.
Bedoka public API, otel ve teknoloji iş ortaklarının Bedoka envanterine programatik olarak erişmesini sağlar. Otel ve oda verisini çekebilir, güncel fiyat ve müsaitliği sorgulayabilir, rezervasyon olaylarını webhook'larla anlık olarak alabilirsiniz. API şu anda beta aşamasındadır ve erişim başvuru ile açılır.
Neler yapabilirsiniz?
Otel envanteri
Otel, oda tipi ve pansiyon bilgilerini programatik olarak listeleyin ve eşleştirin.
Fiyat & müsaitlik
Tarih bazlı fiyat ve kontenjan verisini çekin; kendi sisteminizde güncel tutun.
Rezervasyon webhook'ları
Yeni rezervasyon, değişiklik ve iptal olaylarını anlık olarak kendi uç noktanıza alın.
Kimlik doğrulama
Her istek bir API anahtarı ile yetkilendirilir. Anahtarınızı panel.bedoka.com → Kanal Yöneticisi sayfasından kendiniz üretirsiniz (otel başına). Anahtarı Authorization: Bearer başlığında gönderin. Anahtarlar gizli tutulmalı, yalnızca sunucu tarafında saklanmalı ve istemci kodunda açığa çıkarılmamalıdır.
Örnek istekler
Aşağıda müsaitlik/fiyat çekme, ARI gönderme, rezervasyon çekme ve webhook akışı yer alır:
# 1) Müsaitlik + fiyat çek (kuruş cinsinden)
GET https://api.bedoka.com/v1/partner/availability?from=2026-07-01&to=2026-07-05
Authorization: Bearer bdk_live_xxxxxxxxxxxxxxxx
# 200 OK
{ "from": "2026-07-01", "to": "2026-07-05", "rooms": [
{ "roomCode": "STD-DBL", "days": [
{ "date": "2026-07-01", "available": 4, "priceCents": 8400, "closed": false }
] }
] }
# 2) Müsaitlik + fiyat gönder (ARI push) — (roomCode, date) bazında upsert
PUT https://api.bedoka.com/v1/partner/availability
Authorization: Bearer bdk_live_xxxxxxxxxxxxxxxx
Content-Type: application/json
{ "updates": [
{ "roomCode": "STD-DBL", "date": "2026-07-01", "available": 3, "priceCents": 9000 },
{ "roomCode": "STD-DBL", "date": "2026-07-02", "available": 0, "closed": true }
] }
# 3) Rezervasyonları çek
GET https://api.bedoka.com/v1/partner/bookings?from=2026-07-01&to=2026-07-31
# 4) Webhook (yeni/onaylı rezervasyon) — uç noktanıza POST edilir
# Başlık: x-bedoka-signature: HMAC-SHA256(secret, gövde)
{ "event": "booking.confirmed", "data": {
"code": "BK-XXXX", "roomCode": "STD-DBL", "checkin": "2026-07-01",
"checkout": "2026-07-05", "totalPriceCents": 33600 } }Rate limit
API kullanımı adil kullanım sınırlarına tabidir. Beta döneminde varsayılan sınır iş ortağı başına dakikada 60 istek'tir. Sınır aşıldığında uç nokta 429 Too Many Requests döndürür; istemcinizin Retry-After başlığını dikkate alması beklenir. Daha yüksek limit ihtiyaçları başvuruda değerlendirilir.
API anahtarı
Bearer token ile yetkilendirme.
60 istek / dk
Beta varsayılan rate limit.
Webhook'lar
Rezervasyon olayları anlık iletilir.
Entegrasyona başlayın
Otel panelinize giriş yapın, Kanal Yöneticisi sayfasından API anahtarınızı üretin ve müsaitlik/fiyat göndermeye başlayın. Otel hesabınız yoksa hemen ücretsiz oluşturun.