Cloudbeds API Entegrasyon Rehberi

Cloudbeds entegrasyonu PMS'i operational source olarak korurken local canonical identity, downstream channel state ve analytics projection'ı ayırmalıdır. Cloudbeds API profili platform rolünü açıklar.

Production senaryosu

Reservation Cloudbeds içinde modify olurken bir worker booking import ediyor, başka process analytics projection üretiyor. Version/reconciliation kuralı yoksa tüm API call'lar başarılı olsa bile sistemler farklı state tutabilir.

Access ve credential

Cloudbeds property-level ve partner access modellerini dokümante eder. Credential server-side kalmalı, intended property scope ile sınırlandırılmalı ve test/prod ayrılmalıdır.

Public reference sayfası tek başına her endpoint'in erişilebilir olduğunu kanıtlamaz.

Identity model

Explicit mapping kullanın:

internal_property_id <-> cloudbeds_property_id
internal_booking_id  <-> cloudbeds_reservation_id

PMS ID'lerini channel veya analytics genel ID'si yapmayın.

Synchronization

Incremental sync + durable checkpoint tercih edin. Source update time, received time ve local version saklayın.

Polling kullanılıyorsa late change kaçırmamak için overlap window; duplicate işlememek için stable identity/version dedup gerekir.

Rate limiting

Cloudbeds API rate-limit davranışını dokümante eder. User-facing request'lerin tüm quota'yı tüketmesi yerine queue-based concurrency ve backoff kullanın. Interactive/background bütçelerini mümkünse ayırın.

Reservation lifecycle

Create, modification, cancellation ve payment-related state tek status'a indirgenmemeli; reconciliation ile yönetilmelidir. Timeout duplicate create gerekçesi değildir.

Failure mode'lar

Property scope hatası, duplicate import, missed polling window, quota exhaustion, PII log leak ve booking/payment divergence temel risklerdir.

Observability

Request ID, rate-limit response, sync lag, checkpoint age, mapping miss, dedup hit ve reservation divergence izlenmelidir.

Production checklist

• scoped secret,
• property mapping,
• durable checkpoint,
• overlap/dedup,
• quota-aware queue,
• PII-safe log,
• reservation reconciliation,
• request-ID tracing,
• test/prod ayrımı.

PMS entegrasyonu local projection'ların authoritative property state'e geri açıklanabildiği ölçüde sağlıklıdır.