Search API

Bu metod, esnek oda arama istekleri için kullanılır. Uygunluk isteği göndermeden önce bazı filtreler ve özel özellikler uygulanabilir.

📍 Endpoint

POST https://mg.mescogo.com/gw/api/price/mg-hotel-prices

Özellik	Değer
URI	BaseURL/api/price/mg-hotel-prices
Method	POST
Content-Type	application/json

📋 Request Parametreleri

Parametre	Tip	Açıklama
CheckIn	String	Konaklama giriş tarihi. Format: YYYY-MM-DD
CheckOut	String	Konaklama çıkış tarihi. Format: YYYY-MM-DD
HotelCodes	String	Virgülle ayrılmış MescoMG otel kodları. Maksimum 50 otel kodu.
GuestNationality	String	Varsayılan misafir ülke kodu (ISO 3166-1 alpha-2). Örnek: Tayland: TH, Vietnam: VN
PaxRooms	Object List	Zorunlu oda konaklama listesi. En az bir oda içermelidir. Her öğe Adults, Children ve ChildrenAges alanlarını içerir.
PaxRooms[].Adults	Integer	Zorunlu. Desteklenen aralık: oda başına 1-10 yetişkin.
PaxRooms[].Children	Integer	ChildrenAges.length ile aynı olmalıdır. Çocuk yoksa Children: 0 ve ChildrenAges: [] gönderin.
PaxRooms[].ChildrenAges	Integer Array	Odadaki çocuk yaşları. Children değeri 0 ise boş array gönderin.
ResponseTime	Decimal	Zorunlu beklenen yanıt süresi (saniye).
IsDetailedResponse	Boolean	Arama yanıtında gün bölünmesi ve detaylı iptal politikaları gibi ek detaylar almak için. Varsayılan: false
Filters	Object	Arama yanıtını daraltmak için filtreler. Bu objeyi gönderin; filtre kullanılmayacaksa örnekte gösterilen varsayılan değerleri kullanın.
Filters.Refundable	Boolean	Sadece iade edilebilir oda gereksinimi. Varsayılan: false
Filters.NoOfRooms	Integer	Yanıtta almak istediğiniz maksimum oda sayısı filtresi
Filters.MealType	String	Mevcut yemeklere göre filtre. Değerler: Static Data => Board Types
BookingCode	GUID	Daha önce gönderilen fiyat arama sorgusunun sonucunda dönen rezervasyon kodu ile fiyat kontrolü yapılır

BookingCode Notları

• Booking code alanı boş ise, yeni bir fiyat araması olarak algılanır
• Dolu ise, daha önce gönderilen fiyat arama sorgusunun fiyatı kontrol edilir
• Her sorgunun bir geçerlilik tarihi vardır

📤 Örnek Request (Çoklu Oda)

{
  "CheckIn": "2026-12-29",
  "CheckOut": "2026-12-31",
  "HotelCodes": "26090",
  "GuestNationality": "RU",
  "PaxRooms": [
    {
      "Adults": 2,
      "Children": 1,
      "ChildrenAges": [4]
    }
  ],
  "ResponseTime": 1,
  "IsDetailedResponse": true,
  "Filters": {
    "Refundable": false,
    "NoOfRooms": 0,
    "MealType": "All"
  },
  "BookingCode": ""
}

📥 Response Parametreleri

Parametre	Tip	Açıklama
Status	Object	Yanıt durumu
Status.Code	Integer	Yanıt durum kodu
Status.Description	String	Açıklayıcı mesaj
HotelResult	Array	Oteller hakkında bilgi
HotelResult[].HotelCode	Integer	MescoMG Otel Kodu
HotelResult[].Currency	String	Müşterinin API profilindeki para birimi
HotelResult[].Rooms	Array	Rezerve edilebilir odaların listesi

Rooms Yapısı

Parametre	Tip	Açıklama
Name	Array of String	Oda isimlerinin listesi
RoomId	Integer	Oda ID
BookingCode	GUID	Rezervasyon kodu
Inclusion	String	Dahil olanlar
DayRates	Array	Otelde kalınan her güne göre fiyat dağılımı
BasePrice	Decimal	Oda temel fiyatı
TotalFare	Decimal	Rezerve edilebilir birimin toplam fiyatı
TotalTax	Decimal	Rezerve edilebilir birimin toplam vergisi
RoomPromotion	Array	Oran üzerindeki promosyonların listesi
CancelPolicies	Array	İptal politikalarının detaylı listesi
MealType	String	Yemek tipi
IsRefundable	Boolean	İade edilebilir mi
WithTransfers	Boolean	Transfer dahil mi
Supplements	Array	Ek vergilerin listelendiği bölüm
CustomRow	Decimal	Özel satır
ValidityDate	DateTime	Booking code'un geçerlilik tarihi

CancelPolicies Yapısı

Parametre	Tip	Açıklama
Index	Integer	Index dönüyorsa politika öğesinin listedeki sıralı satır numarasıdır.
FromDate	String	İptal politikasının uygulanmaya başladığı tarih ve saat.
ChargeType	String	İptal cezası tipi. Dönen değerler percent, amount, nights veya ücret birimi sınıflandırılamadığında unknown olabilir.
CancellationCharge	Decimal	Ücret değeri. percent için yüzde oranıdır. amount için oda para birimindeki tutardır. nights için ücretlendirilecek gece sayısıdır. unknown için değerden yüzde, tutar veya gece sayısı anlamı çıkarmayın.

Supplements Yapısı

Parametre	Tip	Açıklama
Index	Integer	İndeks oranını belirtir
Type	String	Ek ücret tipi
Description	String	Ek detayları
Price	Decimal	Ek ücretler
Currency	String	Ek ücretler için geçerli para birimi

📥 Örnek Response

{
  "Status": {
    "Code": 200,
    "Description": "Successful"
  },
  "HotelResult": [
    {
      "HotelCode": 26090,
      "Currency": "USD",
      "Rooms": [
        {
          "Name": ["Triple Room"],
          "RoomId": 0,
          "BookingCode": "0906c991-6d39-46d3-ad78-d198c6801b52",
          "Inclusion": "",
          "DayRates": [
            [
              { "BasePrice": 102.1440 },
              { "BasePrice": 102.1440 }
            ]
          ],
          "TotalFare": 218.11,
          "TotalTax": 13.82,
          "RoomPromotion": [],
          "CancelPolicies": [
            {
              "FromDate": "2026-12-29T00:00:00",
              "ChargeType": "percent",
              "CancellationCharge": 100
            },
            {
              "FromDate": "2026-12-27T00:00:00",
              "ChargeType": "percent",
              "CancellationCharge": 90
            },
            {
              "FromDate": "2026-12-22T00:00:00",
              "ChargeType": "percent",
              "CancellationCharge": 50
            },
            {
              "FromDate": "2026-12-15T00:00:00",
              "ChargeType": "percent",
              "CancellationCharge": 20
            }
          ],
          "MealType": "FB",
          "IsRefundable": false,
          "Supplements": [
            {
              "Index": 1,
              "Type": "",
              "Description": "Gecelik %10 şehir vergisi (fiyata dahil değil)",
              "Price": 13.82,
              "Currency": "USD"
            },
            {
              "Index": 2,
              "Type": "",
              "Description": "Gecelik %8 hizmet vergisi (fiyata dahil)",
              "Price": 11.26,
              "Currency": "USD"
            },
            {
              "Index": 3,
              "Type": "",
              "Description": "Ek vergiler: oda başına gece başı %15 (fiyata dahil)",
              "Price": 22.8,
              "Currency": "USD"
            }
          ],
          "WithTransfers": false,
          "CustomRow": 14.29,
          "ValidityDate": "2026-12-22T09:53:05.3847699+00:00"
        }
      ]
    }
  ]
}