Sorğular və cavablar

Bu səhifədə sorğu gövdələrinin formatları, cavab zərfi, səhifələmə, tarix və məbləğ formatları, həmçinin HTTP status kodlarının necə şərh olunacağı izah edilir.

Sorğu gövdələri#

Son nöqtələr iki gövdə formatından birini istifadə edir. Hansının tətbiq olunduğu hər son nöqtənin arayış səhifəsində göstərilib.

Format	Content-Type	Harada istifadə olunur
Forma sahələri	`application/x-www-form-urlencoded` və ya `multipart/form-data`	Giriş, otaq siyahısı, kuponun yoxlanılması, ölkələr
JSON	`application/json`	Rezervasiyanın ötürülməsi (`BookingPushRQ`), ödənişin başladılması
Sorğu sətri	—	Bütün `GET` son nöqtələri

Forma gövdələrində massiv sahələri kvadrat mötərizələrlə təkrarlanır: childAges[]=7&childAges[]=12. JSON gövdələri UTF-8 kodlaşdırmasında olmalıdır.

Cavab zərfi#

Cavablar JSON formatındadır. Əksəriyyəti success göstəricisi daşıyır; siyahılar count və items ilə qayıdır:

Siyahı cavabı (qısaldılıb)

{
    "success": true,
    "count": 3,
    "items": [
        {
            "id": 1,
            "titleCode": "TRY",
            "symbol": "₺",
            "price": 1
        },
        {
            "id": 2,
            "titleCode": "EUR",
            "symbol": "€",
            "price": 47.85000000000000142108547152020037174224853515625
        }
    ]
}

Biznes qaydası yoxlamasından keçməyən sorğular success: false və xətanın təsvirini iki formadan birində qaytarır:

message forması

{
    "success": false,
    "message": "online_cupon_is_not_found"
}

errorCode forması (otaq siyahısı)

{
    "success": false,
    "errorMessage": "Invalid parameters.",
    "errorCode": 10022
}

İstisnalar: əlaqə məlumatları son nöqtəsi zərfsiz, sadə obyekt qaytarır, rezervasiyanın ötürülməsi isə BookingPushRS obyekti qaytarır. Hər ikisi arayışda göstərilib.

HTTP status kodları#

Kod	Nə vaxt	Nə etməli
200	Sorğu emal olundu (uğurlu və ya biznes qaydası xətası)	`success`, `message` / `errorCode` sahələrini yoxlayın.
401	Token yoxdur, düzgün formatda deyil və ya naməlumdur	Yenidən daxil olun; bax: Autentifikasiya.
404	Yol parametri heç bir qeydə uyğun gəlmir (məs. `/hotel/{hotelID}/…`, `/payment/type/{paymentType}`)	ID-ni yoxlayın.
405	Yanlış HTTP metodu	Arayışda göstərilən metoddan istifadə edin (ölkələr və otaq siyahısı `POST`-dur).
500	Gözlənilməz server xətası	Qısa fasilədən sonra təkrarlayın; xəta davam edərsə, sorğunu əlavə edərək dəstək müraciəti açın.

Səhifələmə#

Siyahı son nöqtələri (/external/currencies, /external/languages, /external/online/social/media, /external/stock/packages) səhifə nömrəsinə görə səhifələnir:

Parametr	Təsvir	Defolt
`limit`	Hər səhifədəki qeyd sayı.	`20`
`page`	Səhifə nömrəsi, 1-dən başlayır.	`1`
`offset`	Buraxılacaq qeydlərin sayı. Verilərsə, `page` nəzərə alınmır.	—
`order`	Sıralama sahəsi; azalan sıra üçün əvvəlinə `-` əlavə edin (`-id`). İcazə verilən sahələr hər son nöqtə üçün ayrıca göstərilib.	—

count qeydlərin ümumi sayıdır; page × limit ≥ count olduqda siyahı bitmiş sayılır.

Tarixlər, vaxtlar və məbləğlər#

Tip	Format	Nümunə
Sorğu tarixi	`YYYY-MM-DD`	`2026-08-18`
Mövcudluq tarixi	`YYYY-MM-DD` və ya `YYYY-MM-DDTHH:MM:SS`	`2026-08-18T12:00:00`
Gecəlik qiymət tarixi (cavab)	`DD.MM.YYYY` (`tarih` sahəsi)	`18.08.2026`
Mövcudluq günü aralığı (cavab)	`YYYY-MM-DD HH:MM:SS`, saat 12:00-dan növbəti gün 12:00-dək	`2026-08-18 12:00:00`
Məbləğ	İki onluq rəqəmli sətir, ayırıcı nöqtədir	`"965.00"`
Valyuta	ISO 4217; otelin onlayn kanal ayarlarından götürülür	`TRY`
Saat qurşağı	Otelin saat qurşağı	Europe/Istanbul

Çıxış tarixi qalma müddətinə daxil deyil: 18–20 avqust iki gecədir. Məbləğləri float ilə toplamayın; onluq ədədlər kitabxanasından və ya kiçik vahidlərdə tam ədədlərdən istifadə edin.

Dil#

Otaq siyahısı language sahəsini (ISO 639-1: tr, en, de…) qəbul edir və otaq adlarını, xüsusiyyət başlıqlarını və xəta mesajlarını həmin dildə qaytarır. Paket siyahısı languageID gözləyir; ID-lər Dillər son nöqtəsindən götürülür.

Son yenilənmə: 21 sentyabr 2026Səhv tapdınız? Bizə bildirin