H2B API – Properties: Rooms
Această metodă returnează lista camerelor disponibile pentru o anumită unitate de cazare. Opțional, poate include și planurile tarifare asociate fiecărei camere, utile pentru afișare, rezervări și gestionare dinamică.
Se recomandă rularea acestei metode ori de câte ori este nevoie să sincronizezi structura de camere a unei proprietăți (ex. în momentul onboardingului sau al actualizării manuale).
Endpoint:
POST /api/?type=properties&call=properties-rooms
Request
URL: /api/?type=properties&call=properties-rooms
Content-Type: application/x-www-form-urlencoded
Post:
auth_key=API_Key
PropertyId=319
With_Rate_Plans=1
Parametri explicați:
auth_key
Tip: string
Obligatoriu: Da
Cheia de autentificare a utilizatorului API.
PropertyId
Tip: integer
Obligatoriu: Da
ID-ul unității de cazare pentru care se solicită camerele (obținut din metoda Properties – Properties).
With_Rate_Plans
Tip: integer (0 sau 1)
Obligatoriu: Nu
Dacă este setat la 1, răspunsul va conține și planurile tarifare disponibile pentru fiecare cameră.
Response:
{
"Id": 956,
"Name": "Camera dubla",
"Property": {
"Id": 319,
"Name": "Hotel Test B2B"
},
"Standard_Type": "Twin/Double",
"Occupancy": {
"Name": "Ocupare 2 persoane",
"Persons_Max": 3,
"Adult_Limits": { "Default_From": 2, "Default_To": 2 },
"Child_Limits": { "Default_From": 0, "Default_To": 0 }
},
"Count": 5,
"Size": 20,
"Content_Description_HTML": "<p>ddsfasdfasdf</p>",
"Content_Images": [
{
"Path": "bed_4416515_640_67d283e0e8e62.jpg",
"Order": 1,
"_url_": "https://portal.h2b.ro/uploads/seo-images/"
}
],
"Property_Room_Beds": [
{
"Bed_Type": "Double Bed",
"Number_Of_Beds": 1,
"Add_Alternative_Bed": 1,
"Alternative_Bed_Type": "Single bed",
"Alternative_Number_Of_Beds": 2
}
],
"Property_Room_Facil_Top": {
"Air_Conditioning": "paid",
"Balcony": 1,
"Flat_Screen_TV": 1
},
"Property_Room_Facil_Other": {
"Free_Toiletries": 1,
"Hairdryer": 1,
"Tea_Coffee_Maker": 1
},
"Rate_Plans": [
{ "Id": 536, "Name": "Tarife flexibile 3", "Active": 1 },
{ "Id": 537, "Name": "Tarife Nerambursabile 4", "Active": 1 }
]
}
Observații:
Dacă With_Rate_Plans=1, câmpul Rate_Plans va conține lista planurilor tarifare disponibile pentru acea cameră, fiecare cu ID și denumire.
