Tehnička API specifikacija

start_date i end_date u blokovima uvek stižu kao ISO datetime sa vremenskom zonom (npr. "2026-07-01T10:00:00+00:00") - i kod dnevnih tipova, gde je vreme 00:00:00. Za satne tipove vreme je značajno i blokira tačan interval. Ako vam treba samo datum, uzmite String(v).split('T')[0].

Termin se smatra zauzetim po pravilu preklapanja: postojeći blok blokira novi zahtev samo ako se intervali stvarno seku. Zato check-out jednog gosta i check-in drugog mogu biti isti dan, a dva satna termina isti dan ne smetaju jedan drugom ako se ne preklapaju.

Polje address je ravan string koji sistem automatski sastavlja iz strukturirane adrese, redosledom ulica, poštanski broj, grad, država. Ako vam adresa treba po delovima, koristite objekat details.location sa poljima street, city, postalCode, country. Top-level polje location ne postoji u odgovoru.

Polja check_in i check_out su podrazumevana vremena dolaska i odlaska za jedinicu (npr. "14:00"), namenjena prikazu na sajtu. Ona ne ograničavaju vrednosti koje šaljete u POST /api/v1/bookings - API ih pri kreiranju rezervacije ne proverava.

Polje description je slobodan tekst koji vlasnik piše sam i može da sadrži prelome redova (\n) kojima deli pasuse. Prikažite ga sa CSS pravilom white-space: pre-line, inače pregledač sve prelome pretvori u razmake i opis se slije u jedan pasus. Stariji zapisi mogu imati i \r\n; pre-line pravilno obrađuje oba.

Cenu ne morate računati sami: pricing_config je informativan, a konačan iznos server obračunava pri kreiranju rezervacije.

Ako cenu prikazujete unapred, pricing_config se čita ovako. base_price je osnovna cena po noći (satu, danu). tiers su cene po broju gostiju (odrasli + deca, bez beba): pravilo sa guests_exact važi za tačno toliko osoba i ima prednost, zatim prvo pravilo po redu sa guests_up_to ili guests_from koje odgovara. seasons su periodi sa svojom cenom (date_from i date_to uključivo, i sopstvena pravila po broju gostiju); sezona se bira prema datumu dolaska i važi za ceo boravak. Na kraju se dodaju cleaning_fee (jednom) i dodatne usluge iz addons.

Opremljenost. Polje amenities je niz id-jeva, npr. ["wifi", "fridge"]. Može biti prazno ili izostati. Id-jevi su vezani za tip jedinice i ne smeju se spajati između tipova: heating kod smeštaja znači „Grejanje", a kod bazena „Grijanje". Zato nemojte praviti sopstvenu tabelu id → naziv.

Umesto toga dodajte ?include=amenities_detailed na zahtev. Odgovor tada uz svaku jedinicu nosi i razrešen oblik, spreman za prikaz:

"amenities_detailed": [
  { "id": "wifi",   "label": "WiFi",      "group": "Opšte",   "icon": "wifi" },
  { "id": "fridge", "label": "Frižider",  "group": "Kuhinja", "icon": "refrigerator" }
]

• label je na jeziku klijenta. Koji je to jezik piše u polju language na vrhu odgovora ("sr", "sl" ili "bs"). Polje language stiže uvek, i bez include.
• group je naziv sekcije i uvek je na srpskom, bez obzira na jezik klijenta. Kod smeštaja su to Opšte, Kuhinja, Kupatilo, Spavaća soba, Dnevni boravak, Wellness, Spoljašnji prostor, Pogled, Porodica, Bezbednost, Pristupačnost, Usluge. Ako naslove sekcija prikazujete na drugom jeziku, prevedite ih sami. Može biti null kod tipova koji još nisu podeljeni na sekcije - tada prikažite sve u jednom bloku.
• icon je stabilan naziv ikonice, npr. "refrigerator". Vrednosti se ne menjaju i poklapaju se sa nazivima iz skupa lucide, pa ako ga već koristite, mapiranje radi samo od sebe. Može biti null.
• Grupišite po polju group, ne po redosledu. Stavke su uglavnom poređane po sekcijama, ali dodatne stavke pojedinih tipova (npr. doručak kod Sobe, roštilj kod Kuće) stižu na kraju spiska. Ko iscrtava naslov sekcije pri svakoj promeni grupe dobiće istu sekciju dva puta. Primer ispod grupiše ispravno.

Prikaz po sekcijama, kao na velikim sajtovima za smeštaj, tada staje u petnaestak linija:

const res = await fetch(
  'https://gost365.app/api/v1/units?include=amenities_detailed',
  { headers: { 'x-api-key': API_KEY } }
)
const { data } = await res.json()

for (const jedinica of data) {
  const sekcije = {}
  for (const a of jedinica.amenities_detailed ?? []) {
    const g = a.group ?? 'Ostalo'
    ;(sekcije[g] ??= []).push(a)
  }

  for (const [naziv, stavke] of Object.entries(sekcije)) {
    console.log(naziv)
    for (const a of stavke) {
      console.log('  ', IKONICE[a.icon] ?? '•', a.label)
    }
  }
}

Ako ne koristite biblioteku ikonica, prekopirajte ovu tabelu i gotovi ste:

const IKONICE = {
  'wifi': '📶', 'air-vent': '❄️', 'flame': '🔥', 'arrow-up-down': '🛗',
  'trees': '🌳', 'fence': '🏞️', 'circle-parking': '🅿️', 'warehouse': '🚘',
  'waves': '🏊', 'dog': '🐕', 'cigarette': '🚬', 'croissant': '🥐',
  'beef': '🍖', 'sprout': '🌱', 'chef-hat': '🍳', 'refrigerator': '🧊',
  'cooking-pot': '🍲', 'microwave': '🍱', 'utensils-crossed': '💧', 'coffee': '☕',
  'soup': '🥣', 'shower-head': '🚿', 'bath': '🛁', 'wind': '💨',
  'washing-machine': '🧺', 'layers': '🧖', 'sparkles': '✨', 'door-open': '🚪',
  'bed-double': '🛏️', 'shirt': '👕', 'bed-single': '🛌', 'baby': '👶',
  'tv': '📺', 'sofa': '🛋️', 'utensils': '🍽️', 'laptop': '💻',
  'fan': '🌀', 'volume-x': '🔇', 'door-closed': '🚪', 'plug-zap': '🔌',
  'snowflake': '❄️', 'glass-water': '🫖', 'sandwich': '🍞', 'blender': '🥤',
  'salad': '🧂', 'wine': '🍷', 'droplet': '💧', 'thermometer': '🌡️',
  'footprints': '🩴', 'blinds': '🪟', 'bed': '🛏️', 'monitor-play': '🎬',
  'satellite-dish': '📡', 'speaker': '🔊', 'book-open': '📚', 'dices': '🎲',
  'gamepad-2': '🎮', 'armchair': '🪑', 'dumbbell': '🏋️', 'heater': '♨️',
  'droplets': '🫧', 'sun': '☀️', 'umbrella': '⛱️', 'tree-palm': '🏖️',
  'sailboat': '⛵', 'mountain-snow': '🏔️', 'building-2': '🏙️', 'flower-2': '🌷',
  'toy-brick': '🧸', 'puzzle': '🛝', 'shield': '🛡️', 'alarm-smoke': '🚨',
  'siren': '⚠️', 'fire-extinguisher': '🧯', 'briefcase-medical': '🩹', 'vault': '🔐',
  'cctv': '📹', 'lock-keyhole': '🔒', 'person-standing': '🚶', 'accessibility': '♿',
  'hand': '✋', 'key-round': '🔑', 'luggage': '🧳', 'plane': '✈️',
  'spray-can': '🧹', 'calendar-days': '📅', 'bike': '🚲', 'concierge-bell': '🛎️',
}