Booking Detail API

Bu yöntem, mevcut bir rezervasyonun güncel public detay kaydını döndürür.

Yanıtta rezervasyon, konaklama, misafir, oda, meal/board, fiyat, para birimi ve ödeme alanları bulunabilir. Rezervasyonda bulunmayan değerler yanıta göre boş veya eksik olabilir.

📍 Endpoint

GET {BaseURL}/api/booking/booking-detail?bookingID=00000000-0000-4000-8000-000000000001

Örnek veri notu: Buradaki bookingID sentetik ve açıklama amaçlıdır. Canlı rezervasyon verisi olarak kopyalamayın.

Özellik	Değer
URI	{BaseURL}/api/booking/booking-detail?bookingID={bookingID}
Method	GET
Content-Type	application/json

Yetkilendirme

Authentication sayfasında açıklanan Basic Auth header'ını gönderin.

📋 Request Parametreleri

Parametre	Tip	Açıklama
bookingID	String	Rezervasyon tanımlayıcısı query parametresi. Booking, booking-detail veya booking-list yanıtından dönen tam ConfirmationNumber veya BookingId değerini gönderin.

🔐 Yetkilendirme

Bu uç nokta, diğer booking endpointleriyle aynı API istemci kimlik bilgilerini kullanan bir Basic Authorization başlığı gerektirir.

📤 Örnek Request

GET {BaseURL}/api/booking/booking-detail?bookingID=00000000-0000-4000-8000-000000000001 HTTP/1.1
Authorization: Basic base64(kullaniciAdi:parola)

Örnek veri notu: Yukarıdaki tanımlayıcı ve header değerleri sentetik ve açıklama amaçlıdır. Canlı rezervasyon veya müşteri verisi olarak kopyalamayın.

📥 Yanıt Parametreleri

Parametre	Tip	Açıklama
timestamp	String	ISO benzeri sunucu zaman damgası
content	Object	Rezervasyon detay yükü
content.status	String	Rezervasyon durumu
content.dates.from	String	Giriş tarihi
content.dates.to	String	Çıkış tarihi
content.bookingId	Integer	Rezervasyon tanımlayıcısı
content.reference	Object	Rezervasyonla ilişkili referans değerleri
content.reference.agency	String	Rezervasyonla ilişkili opak referans. ClientReferenceId veya BookingReferenceId ile aynı olduğu varsayılmamalıdır.
content.leadGuest	Object	Ana misafir bilgisi
content.leadGuest.guestId	Integer	Ana misafir tanımlayıcısı
content.leadGuest.birthDate	String	Ana misafir doğum tarihi
content.leadGuest.name.first	String	Ana misafir adı
content.leadGuest.name.last	String	Ana misafir soyadı
content.leadGuest.contact	Object	Ana misafir iletişim detayları
content.leadGuest.title	String	Ana misafir unvanı
content.leadGuest.age	Integer	Ana misafir yaş bilgisi
content.propertyId	Integer	MescoGo otel tanımlayıcısı
content.roomName	String	Rezervasyon verisinde varsa oda adı
content.meal	String	Rezervasyon detayından dönen meal veya board adı/kodu
content.board	String	Varsa board kodu/adı. Örnek: BB, HB, FB, AI, RO
content.price	String	Varsa rezervasyon/sipariş fiyatı
content.currency	String	content.price alanının para birimi
content.isPaid	Boolean	Yalnızca MescoGo rezervasyon ödemesinin tamamlandığını doğrulayabiliyorsa true olur.
content.paymentStatus	String	Varsa ödeme bilgisi. Boş, unknown veya başka bir değer olabilir; tek başına ödeme onayı olarak kullanılmamalıdır.

📥 Örnek Response

{
  "content": {
    "status": "confirmed",
    "dates": {
      "from": "2030-06-01",
      "to": "2030-06-05"
    },
    "bookingId": 1000001,
    "reference": {
      "agency": "00000000-0000-4000-8000-000000000002"
    },
    "leadGuest": {
      "guestId": 100001,
      "birthDate": "1990-01-01",
      "name": {
        "first": "Sample",
        "last": "Guest"
      },
      "contact": {
        "address": "100 Example Avenue",
        "city": "Sample City",
        "country": "US",
        "nationality": "US",
        "email": "guest@example.com",
        "phone": "+10000000000",
        "state": "Sample State",
        "zip": "00000"
      },
      "title": "Mr",
      "age": 40
    },
    "propertyId": 900001,
    "roomName": "Sample Room",
    "meal": "BB",
    "board": "BB",
    "price": "100.00",
    "currency": "USD",
    "isPaid": false,
    "paymentStatus": "unknown"
  },
  "timestamp": "2030-01-15T10:00:00.000Z"
}

Örnek veri notu: Yukarıdaki tüm değerler sentetik ve açıklama amaçlıdır. Canlı rezervasyon veya müşteri verisi olarak kopyalamayın.

⚠️ Notlar

• Endpoint JSON body kabul etmez; bookingID parametresi sorgu dizesi ile gönderilmelidir.
• Rezervasyon bulunamazsa veya detay sorgusu başarısız olursa genel bir sonuç içinde ResultMessage alanı Record Not Found veya An Unexpected Error Occurred olarak döner.
• Misafir adı alanları rezervasyon verisinde döner. Değerleri API'nin döndürdüğü şekilde kullanın.
• content.status yalnızca rezervasyon durumunu ifade eder. Paid sinyali için öncelikli alan content.isPaid = true değeridir. Bu değer false ise veya content.paymentStatus boş, unknown, tanınmayan ya da tamamlanmış ödemeyi göstermeyen bir değerse ödemeyi doğrulanmamış kabul edin.
• Kimlik doğrulama hataları dokümante edilen HTTP durumlarını kullanır. Kayıt ve işleme sonuçları, HTTP durumu 200 kalırken JSON gövdesi içinde dönebilir.