DerbySoft Connectivity Entegrasyon Rehberi

DerbySoft public olarak supplier ve distributor ilişkilerinde push/pull API modelleri kullanan hotel connectivity yaklaşımını açıklar. Detaylı partner schema'ları access-controlled olabilir; bu nedenle production design public dokümantasyonda olmayan varsayımları hard-code etmek yerine provider-neutral boundary kurmalıdır.

DerbySoft Connectivity profili ekosistem rolünü açıklar.

Production senaryosu

Hotel price/availability değiştirirken distributor shopping data pull ediyor ve aynı anda booking update geliyor. Entegrasyon eski push state, yeni pull observation ve booking lifecycle'ın birbirini yanlış overwrite etmesini engellemelidir.

Push boundary

Source change
 -> canonical ARI event
 -> transactional outbox
 -> DerbySoft adapter
 -> delivery ledger
 -> retry / DLQ / reconciliation

Source revision ve entity/date ordering korunmalıdır.

Pull boundary

Pull/search flow'da concurrency ve cache sınırlandırılmalıdır. Pull response belirli anda observed state'tir; source-of-truth ARI gibi geri yazılmamalıdır.

Mapping

Canonical property/room/rate identity; DerbySoft ve downstream distributor ID'lerinden ayrı tutulmalıdır. Mapping version, status ve audit history taşımalıdır.

Booking lifecycle

Create/update/cancel state ARI projection'dan ayrı reconcile edilmelidir. Connectivity hub booking'i taşısa da local system idempotency ve duplicate protection sağlamak zorundadır.

Public dokümantasyon sınırı

Public product sayfaları flexible push/pull integration'ı açıklar; her partner schema, certification rule veya SLA'yı yayınlamaz. Exact format ve limitler implementation sırasında partner docs'tan alınmalıdır.

Failure mode'lar

Out-of-order ARI, mapping drift, duplicate booking update, stale pull cache, retry amplification ve tüm downstream partner'lara tek contract varsaymak temel risklerdir.

Observability

Delivery lag, pull latency, mapping error, booking reconciliation gap, partner scope ve retry depth izlenmelidir.

Production checklist

• provider-neutral ARI model,
• push/pull pipeline ayrımı,
• mapping versioning,
• delivery ledger,
• bounded retry,
• booking idempotency,
• reconciliation,
• per-partner metrics,
• private-doc/version inventory.

Connectivity hub connection sayısını azaltır; source identity ve state reconciliation ihtiyacını ortadan kaldırmaz.