სწრაფი დაწყება

ამ გვერდზე სასტუმროს HMS პანელში შექმნით API გასაღებს და მიიღებთ სასტუმროში მყოფი სტუმრების სიას. დაგჭირდებათ პანელზე წვდომა ისეთი მომხმარებლით, რომელსაც API გასაღებების მართვის უფლება აქვს; წინააღმდეგ შემთხვევაში გასაღების შექმნა და თქვენთვის გადმოცემა სასტუმროს ადმინისტრაციას შეუძლია.

1. გასაღების შექმნა#

HMS-ის მართვის პანელში გახსენით API გვერდი და გადადით Custom API ჩანართზე.
აღწერის ველში მიუთითეთ, სად გამოიყენება გასაღები (მაგ. Hotspot – მთავარი შენობა), და შეინახეთ. HMS შექმნის 13-სიმბოლოიან გასაღებს.
დააკოპირეთ გასაღები სიიდან. იგი სასტუმროზეა მიბმული და ვადა არ გასდის; სიიდან წაშლისთანავე ძალას კარგავს.

ტერმინალი

export HMS_API_KEY="017f1daf2d139"

ასევე ჩაინიშნეთ სასტუმროს HMS ID; მაგალითებში იგი იგზავნება როგორც HotelCode: 1000. ეს სათაური ვალიდაციისთვის არ გამოიყენება, მაგრამ ჟურნალებში ჩანს, რომელი სასტუმროს მონაცემები იქნა მოთხოვნილი.

2. სიის მიღება#

ენდპოინტი POST მეთოდით გამოიძახება და ტანს არ იღებს:

მოთხოვნა

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"
  }
});
if (res.status === 401) throw new Error("Invalid ApiKey");
const data = await res.json();
for (const g of data.otelde) {
  console.log(g.roomName, g.firstName, g.lastName, new Date(g.checkout * 1000));
}

$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',
    ],
]);
$body = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 401) {
    throw new RuntimeException('Invalid ApiKey');
}
$data = json_decode($body, true);
foreach ($data['otelde'] as $g) {
    echo $g['roomName'], ' · ', $g['firstName'], ' ', $g['lastName'], ' · ', date('d.m.Y', $g['checkout']), "\n";
}

3. პასუხის წაკითხვა#

სასტუმროში მყოფი ყოველი სტუმარი otelde მასივში ცალკე ჩანაწერია. შემოკლებული მაგალითი ერთ ოთახში მყოფი ორი სტუმრისთვის:

პასუხი · 200 (შემოკლებული)

{
    "success": 1,
    "otelde": [
        {
            "unique": 58211,
            "firstName": "AYŞE",
            "lastName": "DEMİR",
            "identityNumber": "11111111110",
            "birthDate": "14.03.1985",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "rezervasyon_id": 282799
        },
        {
            "unique": 58212,
            "firstName": "MEHMET",
            "lastName": "DEMİR",
            "identityNumber": "22222222220",
            "birthDate": "02.11.1982",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "rezervasyon_id": 282799
        }
    ]
}

unique თითოეული სტუმრისთვის უნიკალურია; hotspot-ის მომხმარებელი სწორედ მას დაუკავშირეთ. rezervasyon_id ერთ ოთახში მყოფ სტუმრებს საერთო აქვთ.
პორტალზე მოთხოვნილი ოთახის ნომერი roomName ველს შეედრება, გვარი კი — lastName ველს. მნიშვნელობები ჩვეულებრივ დიდი ასოებითაა.
checkin ჩასახლების მომენტია; checkout გაწერის დაგეგმილი თარიღია (00:00 UTC) დღის დროის გარეშე. სესიის დასასრულის მისაღებად დაუმატეთ სასტუმროს გაწერის საათი.
თუ სასტუმროში არავინ არის, otelde ცარიელი მასივია, success კი მაინც 1 რჩება.

სად გავაგრძელოთ#

სტუმრის ვერიფიკაციის პროცესი — შედარების წესები, სესიის ხანგრძლივობა, პერიოდული სინქრონიზაცია
ავთენტიფიკაცია — გასაღებების მართვა და 401 პასუხი
API ცნობარი — ყველა ველის აღწერა

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