სასტუმროში მყოფი სტუმრები

Hotspot ინტეგრაციის ერთადერთი რესურსი. აბრუნებს ოთახის, პირადობისა და ჩასახლება/გაწერის მონაცემებს ყველა სტუმრისთვის, რომელიც ამჟამად სასტუმროშია (ჩასახლებულია და ჯერ არ გაწერილა). Hotspot პროგრამა ამ სიას რეგულარული ინტერვალებით იღებს და შესაბამისად ხსნის ან ხურავს Wi-Fi ანგარიშებს; ნაბიჯები აღწერილია სახელმძღვანელოში სტუმრის ვერიფიკაციის პროცესი.

POST/public/json/customer/inhotelსასტუმროში მყოფი სტუმრების სია

ობიექტი#

ველები

uniqueinteger

ყოფნის ჩანაწერის ID, უნიკალური ყოველი სტუმრისა და ჯავშნისთვის. hotspot-ის მხარეს იგი გამოიყენეთ მომხმარებლის / სესიის გასაღებად.

rezervasyon_idinteger

ჯავშნის ID. ერთ ოთახში მყოფ სტუმრებს ეს მნიშვნელობა საერთო აქვთ.

inHotelinteger

1 = სტუმარი სასტუმროშია. ყოველთვის 1, რადგან ენდპოინტი მხოლოდ სასტუმროში მყოფ სტუმრებს აბრუნებს.

firstNamestring

სახელი. ჩვეულებრივ დიდი ასოებითაა, რადგან პირადობის დოკუმენტიდან იკითხება; რამდენიმე სახელი ჰარითაა გამოყოფილი.

lastNamestring

გვარი. ჩვეულებრივ დიდი ასოებით.

identityNumberstring | null

თურქეთის პირადი ნომერი ან პასპორტის ნომერი, როგორც დოკუმენტშია მითითებული. შეიძლება ცარიელი იყოს სტუმრებისთვის, რომლებიც პირადობის მონაცემების გარეშე დარეგისტრირდნენ.

birthDatestring | null

დაბადების თარიღი, DD.MM.YYYY. შეიძლება ცარიელი იყოს.

roomIDinteger

ოთახის HMS ID.

roomNamestring

ოთახის სახელი / ნომერი, როგორც სტუმარი ხედავს კარზე და გასაღებ-ბარათზე. პორტალზე „ოთახის ნომრად“ სწორედ ეს მოითხოვეთ.

checkininteger

სტუმრის ჩასახლების დრო, Unix დროის ნიშნული (წამები).

checkoutinteger

გაწერის დაგეგმილი თარიღი, Unix დროის ნიშნული დღის დასაწყისზე (00:00 UTC); დღის დროს არ შეიცავს. სესიის დასასრულის მისაღებად დაუმატეთ სასტუმროს გაწერის საათი (ჩვეულებრივ 12:00).

checkout2integer | null

გაწერის ფაქტობრივი დრო. სასტუმროში მყოფი სტუმრებისთვის null; გაწერის შემდეგ სტუმარი სიიდან ისედაც ქრება.

mikrotikSifrelemeinteger

ოთახის შენობის Mikrotik-ის დაშიფვრის პარამეტრი HMS-ში: 0 ოთახის სახელი (Wi-Fi-ის პაროლი ოთახის ნომერია), 1 პაროლის გარეშე. იგივე პოლიტიკა გამოიყენეთ თქვენს პორტალზე.

01

ობიექტის მაგალითი

{
    "mikrotikSifreleme": 0,
    "unique": 58211,
    "inHotel": 1,
    "identityNumber": "11111111110",
    "firstName": "AYŞE",
    "lastName": "DEMİR",
    "birthDate": "14.03.1985",
    "roomID": 4,
    "roomName": "104",
    "checkin": 1788863400,
    "checkout": 1788998400,
    "checkout2": null,
    "rezervasyon_id": 282799
}

სასტუმროში მყოფი სტუმრების სია#

POST/public/json/customer/inhotel

ავთენტიფიკაცია: ApiKey სათაური

აბრუნებს სასტუმროში მყოფი სტუმრების სრულ სიას. ფილტრის პარამეტრები და მოთხოვნის ტანი არ არის. სტუმარი სიაში ჩნდება, როცა ჯავშანი აქტიურია, ჩასახლება შესრულებულია და გაწერა ჯერ არ მომხდარა, ხოლო სტუმარი მონიშნულია როგორც „სასტუმროშია“. ერთი ჯავშნის თითოეული სტუმარი ცალკე ჩანაწერია.

პასუხი გვერდებად არ იყოფა; დიდ სასტუმროებში შეიძლება რამდენიმე ასეული ჩანაწერი დაბრუნდეს. დააქეშირეთ სია და განაახლეთ იგი რეკომენდებული ინტერვალით.

სათაურები

ApiKeystringსავალდებულო

HMS-ის მართვის პანელში გენერირებული სპეციალური API გასაღები. მიბმულია ერთ სასტუმროზე და სწორედ ის განსაზღვრავს, რომელი სასტუმროს სტუმრები ჩამოითვლება.

HotelCodeinteger

სასტუმროს HMS ID. ვალიდაციისთვის არ გამოიყენება, რადგან სერვერი სასტუმროს გასაღებით განსაზღვრავს; რეკომენდებულია ჟურნალირებისა და თავსებადობისთვის.

პასუხი

200 success: 1 და otelde მასივი. თუ სასტუმროში არავინ არის, მასივი ცარიელია; ეს შეცდომა არ არის.

successinteger

1 წარმატება, 0 წარუმატებლობა. რიცხვია და არა boolean, როგორც Online Booking-ში.

otelde[]object[]

სტუმრების ჩანაწერები. ველებისთვის იხილეთ ზემოთ მოცემული განყოფილება ობიექტი.

შეცდომის პასუხები

401 ApiKey სათაური აკლია, ცარიელია ან HMS-ში განსაზღვრული არ არის (შესაძლოა წაშლილია). ტანი: {"success": 0}.
405 მოთხოვნა გაიგზავნა არა POST, არამედ სხვა მეთოდით (მაგალითად, GET ბრაუზერის მისამართის ზოლიდან).

მოთხოვნა

curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"

const res = await fetch("https://test.hms.gen.tr/public/json/customer/inhotel", {
  method: "POST",
  headers: {
    "ApiKey": process.env.HMS_API_KEY,
    "HotelCode": "1000"
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/public/json/customer/inhotel');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'ApiKey: ' . getenv('HMS_API_KEY'),
        'HotelCode: 1000',
    ],
]);
$data = json_decode(curl_exec($ch), true);

პასუხი · 200

{
    "success": 1,
    "otelde": [
        {
            "mikrotikSifreleme": 0,
            "unique": 58211,
            "inHotel": 1,
            "identityNumber": "11111111110",
            "firstName": "AYŞE",
            "lastName": "DEMİR",
            "birthDate": "14.03.1985",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58212,
            "inHotel": 1,
            "identityNumber": "22222222220",
            "firstName": "MEHMET",
            "lastName": "DEMİR",
            "birthDate": "02.11.1982",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58197,
            "inHotel": 1,
            "identityNumber": "U01234567",
            "firstName": "JULIA",
            "lastName": "WAGNER",
            "birthDate": "27.06.1990",
            "roomID": 12,
            "roomName": "205",
            "checkin": 1788782700,
            "checkout": 1789084800,
            "checkout2": null,
            "rezervasyon_id": 282803
        }
    ]
}

პასუხი · 200 (სასტუმროში სტუმრები არ არიან)

{
    "success": 1,
    "otelde": []
}

პასუხი · 401 (არასწორი გასაღები)

{
    "success": 0
}

ბოლო განახლება: 21 სექტემბერი, 2026იპოვეთ შეცდომა? შეგვატყობინეთ