Booking Detail API

Bu yöntem, mevcut bir rezervasyonun güncel detay kaydını sorgulamak için kullanılır.

Mevcut alanlar aynı şekil ve anlamla korunur. Aşağıdaki oda, meal/board, fiyat, para birimi ve ödeme alanları mevcut entegrasyonları bozmayacak şekilde eklenmiştir.

📍 Endpoint

GET https://mg.mescogo.com/gw/api/booking/booking-detail?bookingID=1531561

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

📋 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 /gw/api/booking/booking-detail?bookingID=1531561 HTTP/1.1
Host: mg.mescogo.com
Authorization: Basic base64(kullaniciAdi:parola)

📥 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.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	Sistemdeki 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	Koruyucu ödeme bayrağı. Yalnızca rezervasyon detayında açık şekilde paid/settled/captured gibi ödeme sinyali döndürülürse true olur
content.paymentStatus	String	Varsa rezervasyon detay ödeme durumu. Güvenilir ödeme/settlement sinyali yoksa unknown döner ve isPaid değeri false olur

📥 Örnek Response

{
  "content": {
    "status": "confirmed",
    "dates": {
      "from": "2026-12-29",
      "to": "2026-12-31"
    },
    "bookingId": 1531561,
    "leadGuest": {
      "guestId": 1,
      "birthDate": "1989-05-11",
      "name": {
        "first": "John",
        "last": "John"
      },
      "contact": {
        "address": "Example Street 10",
        "city": "Antalya",
        "country": "TR",
        "nationality": "TR",
        "email": "john@example.com",
        "phone": "+90 555 000 00 00",
        "state": "Antalya",
        "zip": "07000"
      },
      "title": "Mr",
      "age": 36
    },
    "propertyId": 26090,
    "roomName": "Deluxe Sea View",
    "meal": "BB",
    "board": "BB",
    "price": "456.78",
    "currency": "EUR",
    "isPaid": false,
    "paymentStatus": "unknown"
  },
  "timestamp": "2026-03-31T10:15:00.000Z"
}

⚠️ Notlar

• Endpoint JSON body kabul etmez; bookingID parametresi sorgu dizesi ile gönderilmelidir.
• Rezervasyon bulunamazsa veya istek işleme alınırken hata oluşursa aynı genel yanıt formatı ResultMessage alanında Record Not Found veya An Unexpected Error Occurred ile döner.
• Misafir adı alanları rezervasyon verisinde döner. Değerleri API'nin döndürdüğü şekilde kullanın.
• content.status sadece rezervasyon durumunu ifade eder. Rezervasyon detayında açık bir ödeme/settlement sinyali döndürülmedikçe confirmed rezervasyon paid kabul edilmez.