H2B API – Properties: Properties
Această metodă returnează lista tuturor unităților de cazare la care utilizatorul API are acces. Poate fi folosită pentru sincronizarea și gestionarea locală a proprietăților disponibile în platforma H2B.
Se recomandă rularea automată a acestei metode prin cronjob, la un interval regulat (zilnic sau la câteva ore), în funcție de nevoi.
Endpoint:
POST /api/?type=properties&call=properties-properties
Request
URL: /api/?type=properties&call=properties-properties
Content-Type: application/x-www-form-urlencoded
POST:
auth_key=API_Key
PropertyId=319
City_Id=
Owner_Info=1
Parametri explicați:
auth_key
Tip: string
Obligatoriu: Da
Cheia de autentificare generată în platforma H2B.
PropertyId
Tip: integer
Obligatoriu: Nu
Filtru opțional pentru obținerea detaliilor doar pentru o anumită unitate de cazare.
City_Id
Tip: integer
Obligatoriu: Nu
Filtru opțional pentru a obține proprietăți doar dintr-un anumit oraș (ID-ul obținut din metoda Geography – Cities).
Owner_Info
Tip: integer (1 sau 0)
Obligatoriu: Nu
Dacă este setat la 1, răspunsul va conține și informațiile despre proprietar (secțiunea Owner).
Response exemplu:
{
"Id": 319,
"Name": "Hotel Test B2B",
"Currency": "RON",
"Address": {
"Latitude": 45.6427,
"Longitude": 25.5887,
"City": {
"Id": 408,
"Name": "Brașov"
},
"Country": {
"Id": 1,
"Name": "România",
"Code": "RO"
}
},
"Stars": "1",
"Type": "Tourist boarding house",
"Languages_Spoken": [
{ "Name": "Romana" },
{ "Name": "Engleză" }
],
"Content_Description_HTML": "<p>testdfsdfsdfsdf</p>",
"Content_Image": {
"Path": "building_66789_s_640_67d283c5621a1.jpg",
"_url_": "https://portal.h2b.ro/uploads/seo-images/"
},
"Active": 1,
"Active_By_H2B": 1,
"Owner": {
"Id": 1,
"Name": "INNOMARKETING",
"Reg_No": "J29/1677/2006",
"VAT_No": "RO18904260",
"Bank_Accounts": [
{
"Bank_Name": "Denumire Banca",
"IBAN": "Cont Bancar",
"Currency": "RON"
}
]
}
}
Observații importante:
1. În cazul în care obiectul de răspuns conține și câmpul Search_City, acesta trebuie considerat prioritar față de Address.City atunci când se stabilește localizarea principală a unității de cazare. Cu alte cuvinte, Search_City suprascrie Address.City și trebuie utilizat ca referință oficială pentru orașul în care este clasificată și indexată unitatea.
2. Dacă se solicită Owner_Info=1, în răspuns apare obiectul Owner, care conține datele juridice și bancare ale proprietarului.
