Sürətli başlanğıc

Bu səhifədə partnyor giriş məlumatlarınızla token alacaq və otaq-qiymət sorğusu göndərəcəksiniz. Sizə apiKey, apiSecret və otelin HMS ID-si (hotelID) lazımdır; onlar hələ sizdə yoxdursa, dəstək xidmətinə müraciət edin.

1. Token alın#

Giriş son nöqtəsi forma sahələri qəbul edir və autentifikasiya başlığı tələb etmir:

Terminal

curl "https://test.hms.gen.tr/external/public/login" \
  -d "apiKey=$HMS_API_KEY" \
  -d "apiSecret=$HMS_API_SECRET" \
  -d "hotelCode=1000"

Cavab · 200

{
    "success": true,
    "hotelCode": "1000",
    "token": "eyJlbmREYXRlIjp7ImRhdGUiOiIyMDI2LTA5LTE1IDEwOjI0OjMxLjAwMDAwMCIs…",
    "hotelSeoUrl": "demo-otel"
}

token dəyərini saxlayın; o, 7 gün ərzində bu otel üçün hər sorğuda istifadə olunur.

Terminal

export HMS_TOKEN="eyJlbmREYXRlIjp7ImRhdGUiOiIyMDI2LTA5LTE1IDEwOjI0OjMxLjAwMDAwMCIs…"

2. Otaqları və qiymətləri sorğulayın#

İki böyük üçün iki gecəlik axtarış:

Sorğu

curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" \
  -d "startDate=2026-08-18" \
  -d "endDate=2026-08-20" \
  -d "adultCount=2" \
  -d "language=en"

const res = await fetch("https://test.hms.gen.tr/external/online/roomType", {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.HMS_TOKEN}` },
  body: new URLSearchParams({
    hotelID: "1000",
    startDate: "2026-08-18",
    endDate: "2026-08-20",
    adultCount: "2",
    language: "en"
  })
});
const data = await res.json();
if (!data.success) throw new Error(`${data.errorCode}: ${data.errorMessage}`);
for (const room of data.items) {
  console.log(room.name, room.roomCount, "rooms");
}

$ch = curl_init('https://test.hms.gen.tr/external/online/roomType');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('HMS_TOKEN')],
    CURLOPT_POSTFIELDS     => http_build_query([
        'hotelID'    => 1000,
        'startDate'  => '2026-08-18',
        'endDate'    => '2026-08-20',
        'adultCount' => 2,
        'language'   => 'en',
    ]),
]);
$data = json_decode(curl_exec($ch), true);
if (empty($data['success'])) {
    throw new RuntimeException($data['errorCode'] . ': ' . $data['errorMessage']);
}
foreach ($data['items'] as $room) {
    echo $room['name'], ' · ', $room['roomCount'], " rooms\n";
}

3. Cavabı oxuyun#

Hər otaq tipi öz qidalanma tiplərini (accommodationTypes), hər qidalanma tipi isə öz qiymət variantlarını (prices) ehtiva edir. Qısaldılmış nümunə:

Cavab · 200 (qısaldılıb)

{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Standard Room",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Bed & Breakfast",
                    "priceType": 0,
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "currency": "TRY",
                            "nonRefundable": "",
                            "id": "2/2"
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "currency": "TRY",
                            "nonRefundable": "[NR]",
                            "id": "2-0/2"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

2-1: 2 nəfər, standart (geri qaytarıla bilən) qiymət. 2-0: 2 nəfər, geri qaytarılmayan qiymət (nonRefundable: "[NR]").
price bütün qalma müddəti üçün ümumi məbləğdir; total gecələrin sayıdır. Gecəlik qiymətlər tam cavabdakı prices[] massivindədir.
Rezervasiyada otaq tipinin id dəyəri roomTypeID, qidalanma tipinin id dəyəri isə ratePlanID kimi göndərilir.

Sonra nə etməli#

Rezervasiya axını — seçimdən BookingPushRQ ötürülməsinədək
Ödəniş axını — oteldə ödəniş, bank köçürməsi, kredit kartı, onlayn ödəniş
Xəta kodları — errorCode və message dəyərləri

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