Booking Cancel API

Bu yöntem, mevcut bir rezervasyon için iptal talebi oluşturur.

📍 Endpoint

POST {BaseURL}/api/booking/cancel

Özellik	Değer
URI	{BaseURL}/api/booking/cancel
Method	POST
Content-Type	application/json

Yetkilendirme

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

📋 Request Parametreleri

Parametre	Tip	Açıklama
ConfirmationNumber	String	İptal edilecek rezervasyonun onay numarası

🔐 Yetkilendirme

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

📤 Örnek Request

{
  "ConfirmationNumber": "00000000-0000-4000-8000-000000000001"
}

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

📥 Başarılı Response

{
  "Status": {
    "Code": 200,
    "Description": "Canceled"
  },
  "ConfirmationNumber": "00000000-0000-4000-8000-000000000001"
}

Örnek veri notu: Bu yanıttaki tüm değerler sentetik ve açıklama amaçlıdır. Canlı rezervasyon verisi olarak kopyalamayın.

📥 Response Parametreleri

Parametre	Tip	Açıklama
Status	Object	Yanıt durumu
Status.Code	Integer	API durum kodu
Status.Description	String	Başarılı response açıklaması
ConfirmationNumber	String	İstekte gönderilen onay numarası

⚠️ Hata Durumları

İşleme Hatası

İptal tamamlanamazsa veya işlem sırasında hata oluşursa endpoint HTTP 200 ile birlikte gövde seviyesinde hata payload'u döndürebilir:

{
  "StatusCode": 500,
  "Message": "An error occurred during processing",
  "Error": "An error occurred during processing"
}

Yetkilendirme hatası

Basic Authorization başlığı eksik veya geçersiz olduğunda endpoint HTTP yetkilendirme yanıtı ve bir durum objesi döndürür:

{
  "Status": {
    "Code": 401,
    "Description": "No Header in Authorization"
  }
}

⚠️ Notlar

• Başarılı yanıt CancellationStatus, CancellationCharge, RefundAmount ve Currency alanlarını içermez.
• Rezervasyon iade edilemez durumdaysa veya iptal edilemiyorsa HTTP 200 ile gövde içinde StatusCode 400 veya 500 dönebilir.
• Geçersiz API kimlik bilgileri, hatanın oluştuğu aşamaya göre HTTP 401 veya 404 dönebilir. Her zaman hem HTTP durumunu hem de yanıt gövdesini işleyin.