MescoMg Hotel API
📋 Değişiklik Günlüğü
| Tarih | Değiştiren | API | Açıklama |
|---|---|---|---|
| 28 Ağustos 2026 | - | Search API | Uyruk kodları, CustomRow kullanımı, otelin yerel saatine göre iptal cezası zamanları ve USD fiyatlandırması netleştirildi. |
| 27 Ağustos 2026 | - | Tüm public API'ler | Müşteriye açık API sözleşmesi ve örnekleri güncellendi, güvenlik yönlendirmeleri eklendi, canlı/test base URL'leri belgelendi. |
| 18 Mayıs 2026 | - | Booking List, Search, Booking, Static Data | Müşteriye açık API dokümantasyonu güncellendi |
| 15 Mayıs 2025 | - | - | Temel API |
🔗 API Base URL'leri
| Ortam | Base URL |
|---|---|
| Live (Canlı) | https://mg.mescogo.com/gw |
| Test | https://mgtest.mescogo.net/gw |
API tarafından döndürülen tüm fiyatlar USD cinsindedir. İptal cezası saatleri otelin yerel saatine göre belirlenir ve UTC'ye veya müşterinin yerel saatine dönüştürülmeden döndürülür.
Aşağıdaki endpoint örneklerinde {BaseURL} kullanın. Kullandığınız ortama ait base URL ile değiştirin; sona tekrar /gw eklemeyin.
📍 API Endpoint'leri
| API | Endpoint |
|---|---|
| Search | {BaseURL}/api/price/mg-hotel-prices |
| Book | {BaseURL}/api/booking/book |
| Booking Detail | {BaseURL}/api/booking/booking-detail |
| Booking List | {BaseURL}/api/booking/book-list |
| Booking Cancel | {BaseURL}/api/booking/cancel |
| Service Status | {BaseURL}/api/service/Status |
| Country List | {BaseURL}/common/common/country-list |
| Region List | {BaseURL}/common/common/region-list |
| City List | {BaseURL}/common/common/city-list |
| Meal Types | {BaseURL}/common/hotel/meal-types |
| Hotel Code List | {BaseURL}/common/hotel/hotel-code-list |
| Hotel Detail | {BaseURL}/common/hotel/hotel-detail |
📊 Yanıt durumu işleme
HTTP durumu ile JSON yanıt gövdesindeki durum kodu birbirinden ayrıdır:
| Katman | Anlamı |
|---|---|
HTTP 200 | İstek API'ye ulaştı. JSON gövdesi yine de Status.Code veya StatusCode içinde bir iş kuralı ya da doğrulama sonucu taşıyabilir. |
HTTP 400 | İstek formatı veya model doğrulaması başarısız oldu. |
HTTP 401 | Authorization başlığı eksik, hatalı biçimde veya kabul edilmemiştir. |
HTTP 404 | İstenen kayıt veya API kimlik bilgileri bulunamadı. |
HTTP 409 | İstek, mevcut uygunluk veya rezervasyon durumuyla çakışıyor. |
HTTP 500 | Beklenmeyen bir sunucu hatası oluştu. |
Search ve booking işlemlerinde HTTP durumunun yanı sıra JSON gövdesini de işleyin. Gövdede sık görülen durum kodları 200 (başarılı), 201 (uygunluk yok), 404 (kayıt veya doğrulama sonucu bulunamadı), 409 (uygunluk ya da rezervasyon çakışması) ve 500 (işleme hatası) değerleridir. Kesin yanıt şekli ilgili endpoint sayfasında açıklanır.