Sabre Travel APIs Entegrasyon Rehberi

Production Sabre entegrasyonu GDS shopping, provider offer identity, booking create ve post-booking servicing'i ayrı lifecycle stage'leri olarak ele almalıdır. Sabre Travel APIs profili platformun distribution ekosistemindeki yerini açıklar; bu rehber implementation architecture'a odaklanır.

Production senaryosu

Kullanıcı air veya hotel arar, bir offer seçer ve transaction'a geçene kadar price/inventory değişir. Normalization sırasında Sabre source reference'ları kaybedilmişse ürün güvenli biçimde rebuild veya validate edilemez.

Adapter boundary

Sabre DTO'larını provider adapter arkasında tutun:

Canonical SearchContext
 -> Sabre request mapper
 -> Sabre API client
 -> raw response snapshot
 -> normalized offers
 -> provider reference store

Sabre ID'leri canonical itinerary/hotel/room identity olmamalıdır.

Shopping ve booking

Shopping output discovery state'tir, transaction truth değildir. İlgili product collection'ın sonraki adımları için gereken source reference'ları persist edin ve booking öncesi gerektiğinde revalidate/rebuild edin.

Normalized offer; provider/source, upstream reference, itinerary/property, fare/rate rule, price component, gerekli ancillary context ve observedAt bilgilerini korumalıdır.

Booking lifecycle

Create, retrieve, modify, cancel ve ticket/service operasyonları booking state machine ile yürütülmelidir. Create sırasında network timeout yaşanırsa sonuç FAILED değil UNKNOWN'dur; retrieval/reconciliation ile kanıtlanmalıdır.

Error taxonomy

Auth, entitlement, validation, no-availability, rate-limit, upstream failure, timeout ve business-rule failure ayrılmalıdır. Retry yalnız operation idempotency'si biliniyorsa otomatik uygulanmalıdır.

Observability

API family, operation, latency, provider correlation ID, normalized offer count, UNKNOWN booking age ve reconciliation gap izlenmelidir.

Failure mode'lar

Stale source reference, normalization sırasında rule kaybı, tüm API family'lerine tek timeout ve ambiguous create sonrası duplicate booking başlıca risklerdir.

Production checklist

• Sabre DTO isolation,
• source reference preservation,
• shopping/booking separation,
• UNKNOWN state,
• operation-specific retry/timeout,
• bounded raw-response lineage,
• modify/cancel testleri,
• auth ve entitlement monitoring.

Sabre entegrasyonu yalnız search success rate ile değil lifecycle doğruluğu ve traceability ile değerlendirilmelidir.

Provider companion özeti

Capability boundary

Sabre Developer Hub yüzlerce REST/SOAP/SDK ürünü ve farklı product collection barındırır. Companion tek bir endpoint contract'ı gibi davranmamalıdır:

Product collection → provisioned entitlement/PCC → specific auth contract → shopping/content operation → provider reference → booking/service operation → reconciliation.

Air, Hotel ve Car için source/reference identity ve servicing capability ayrı tutulmalıdır.

Auth, pagination ve rate-limit yaklaşımı

Sabre'nin tüm ürünleri için tek auth lifetime veya QPS değeri yazmak yanıltıcı olur. REST, SOAP ve yeni MCP surfaces farklı contract'lara sahip olabilir. Current docs + service agreement ilgili product collection için source of truth olmalıdır.

Public Sabre guidance individual service agreement'a göre call limit uygulanabileceğini belirtir. Quota config product/credential bazında tutulmalı, global Sabre constant kullanılmamalıdır.

Freshness, idempotency ve booking recovery

Shopping response transaction truth değildir. Offer/source reference, observed timestamp ve provider correlation ID saklanmalıdır. Create/commit timeout sonrası state UNKNOWN olmalı; retrieve/reconciliation yapılmadan duplicate create uygulanmamalıdır.

Observability

Auth/entitlement rejection, operation latency, source-reference age, normalized result count, booking unknown-state age, servicing failure ve reconciliation drift product family bazında ölçülmelidir.