SiteMinder APIs Entegrasyon Rehberi

SiteMinder connectivity bağımsız HTTP call dizisi değil, hotel system ile distribution channel'lar arasında state synchronization olarak modellenmelidir. SiteMinder API profili platform ailesini açıklar; bu rehber integration architecture'a odaklanır.

Production senaryosu

PMS inventory, price ve restriction değiştirirken channel'dan reservation modification gelir. Ordering ve durable processing yoksa eski update inventory'yi yeniden açabilir veya reservation persist edilmeden acknowledge edilebilir.

Canonical model

Internal property/room/rate ID, SiteMinder ID, downstream channel ID, source revision, projected ARI state ve reservation lifecycle ayrı tutulmalıdır.

Provider ID domain identity olmamalıdır.

ARI delivery

Availability, restriction ve rate değişikliklerini versioned event olarak modelleyin. Transactional outbox ile source state ve delivery intent aynı transaction'da persist edilmelidir.

Worker error class'e göre bounded retry yapmalı, entity/date ordering'i korumalı ve item-level outcome tutmalıdır.

Reservation handling

Create/modify/cancel event'leri idempotent işlenmelidir. Contract uygunsa acknowledgement öncesi durable persist yapın; ardından deterministic booking transition uygulayın.

Duplicate reservation message normal dedup path olmalıdır.

Reconciliation

Delivery success remote sellability kanıtı değildir. Mapping, forward availability, restriction, price, recent reservation ve rejected/pending update'leri schedule ile reconcile edin.

Failure mode'lar

Out-of-order ARI, stale room/rate mapping, duplicate reservation, unbounded retry, provider/channel scope hatası ve premature acknowledgement ana risklerdir.

Observability

Source-to-delivery lag, rejection, outbox age, reservation lag, duplicate event, mapping gap ve reconciliation drift izlenmelidir.

Production checklist

• explicit mapping,
• source revision,
• transactional outbox,
• ordered ARI,
• idempotent reservation state,
• bounded retry,
• reconciliation,
• provider/channel metric,
• test/prod ayrımı.

Channel-management kalitesi downstream'de price, availability ve booking accuracy olarak görünür; transport success yeterli değildir.