H2B API – Geography: Cities

Această metodă oferă lista completă a orașelor și județelor disponibile pentru o anumită țară în sistemul H2B. Este utilă pentru funcționalități precum selectarea destinației într-un formular sau filtrarea ofertelor în funcție de locație.
Se recomandă rularea automată a acestei metode (ex. prin cronjob) o dată pe zi, preferabil pe timp de noapte, pentru a menține baza de date locală sincronizată cu serverul H2B.

Endpoint:
POST /api/?type=geography&call=geography-cities

Request
URL: /api/?type=geography&call=geography-cities
Content-Type: application/x-www-form-urlencoded

POST:
auth_key=API_Key&CountryId=1

Parametri explicați:
auth_key
Tip: string
Obligatoriu: Da
Cheia de autentificare generată în platforma H2B, secțiunea „Useri”.

CountryId
Tip: integer
Obligatoriu: Da
ID-ul numeric al țării pentru care se dorește descărcarea orașelor și județelor. Acest ID se obține din metoda Geography – Countries.

Response:

				
					[
    {
        "Id": 2,
        "Name": "București",
        "type": "county"
    },
    {
        "Id": 2,
        "Name": "București",
        "type": "city"
    },
    {
        "Id": 5,
        "Name": "Județul Brașov",
        "type": "county"
    },
    {
        "Id": 9,
        "Name": "Brașov",
        "type": "city"
    }
]