Tehnička API specifikacija

Brendirane stranice na vašem sajtu. Ako vaš sajt ima rute /a/{adresa} (jedan apartman, za deljenje) i /i/{adresa} (svi apartmani jednog izdavaoca), ovde pitate šta da prikažete. Odgovor nosi samo unit_id i brend izdavaoca; samu jedinicu već imate iz GET /api/v1/units. Jedinica se vraća samo ako je vlasnik uključio Brendiranu stranicu i ako je čekirana za domen iz Origin.

// vrsta=a
{ "success": true, "data": {
  "vrsta": "a",
  "adresa": "apartman-marko",
  "unit_id": "3f2a1b0c-...",
  "izdavalac": {                 // null ako jedinica nema izdavaoca sa stranicom
    "naslov": "Apartmani Marko", // naziv brenda ili ime; null = koristite svoj logo
    "logo_url": "https://...",   // ili null
    "telefon": "+381 64 123 4567", // ili null
    "svi_apartmani": "apartmani-marko", // adresa za /i/, ili null
    "opis": "Apartmani na Kopaoniku, 5 minuta od žičare", // ili null
    "naslovna_url": "https://...", // naslovna slika, ili null
    "boja": "#0F6E56",             // boja brenda, ili null (vaša podrazumevana)
    "kanali": { "whatsapp": true, "viber": false }, // na čemu je telefon; dugme samo za true
    "font": "playfair",            // par fontova, ili null (vaš font)
    "ponude": [                    // ponude koje danas važe (najviše 3); [] = nema
      { "naslov": "Last minute ovog vikenda", "istaknuto": "-15%", "opis": "Za boravke od petka do nedelje.",
        "slika": "https://...", "cta": "Rezerviši", "sablon": "slika", "pozadina": "brend", "odbrojavanje": true, "animacija": "odsjaj", "apartman_adresa": "apartman-marko", "dolazak": "2026-11-24", "odlazak": "2026-11-27",
        "od": null, "do": "2026-10-20" }
    ],
    "razlika_booking": 15,         // na Bookingu oko 15% skuplje, ili null
    "pitanja": [                   // česta pitanja izdavaoca; [] = bez odeljka
      { "pitanje": "Do kada je prijava?", "odgovor": "Od 14 do 20 h." }
    ],
    "domacin": {                   // null kad ništa nije upisano
      "slika_url": "https://...",  // ili null
      "prica": "Zdravo, ja sam Marko...", // ili null; može imati nove redove
      "jezici": ["sr", "en"],      // ISO kodovi; nazive prikazujete vi
      "instagram": "apartmani.marko", // samo korisničko ime, ili null
      "facebook": "apartmani.marko",  // samo ime stranice, ili null
      "tiktok": "apartmani.marko",    // samo korisničko ime, ili null
      "youtube": "apartmanimarko",    // samo ime kanala, ili null
      "odgovor_sati": 2            // obično odgovara za oko 2 h; null bez dovoljno podataka
    }
  }
} }

// vrsta=i
{ "success": true, "data": {
  "vrsta": "i",
  "adresa": "apartmani-marko",
  "brend": {                     // ista polja kao "izdavalac" iznad, bez svi_apartmani
    "naslov": "Apartmani Marko", "logo_url": null, "telefon": null,
    "opis": null, "naslovna_url": null, "boja": null, "domacin": null,
    "kanali": { "whatsapp": true, "viber": true }, "font": null, "pitanja": [], "ponude": [], "razlika_booking": null
  },
  "jedinice": [{ "unit_id": "3f2a...", "adresa": "apartman-marko" }]
} }

// stara adresa, ili /i/ sa samo jednim apartmanom
{ "success": true, "data": { "preusmeri": "/a/nova-adresa" } }

404 Stranica nije pronađena. (isključena, nije na vašem domenu ili ne postoji) · 400 vrsta nije a ni i.

Sadržaj stranice (opis, naslovna_url, boja, domacin) uređuju vlasnik i izdavalac u panelu, na strani Brendirane stranice. boja je u obliku #RRGGBB (velika ili mala slova): jedna od šest ponuđenih ili boja koju je izdavalac sam izabrao. Uvek je dovoljno tamna da beli tekst na njoj bude čitljiv (kontrast najmanje 4.5:1), pa je možete koristiti za dugmad sa belim tekstom. Linkove ka mrežama gradite sami: https://instagram.com/{instagram}, https://facebook.com/{facebook}, https://www.tiktok.com/@{tiktok} i https://www.youtube.com/@{youtube}.kanali kaže da li je telefon na WhatsApp-u i Viberu: dugme prikažite samo za true (izdavalac to bira u panelu). Važi samo za taj telefon, ne za vaš broj za rezervacije. font je par fontova (naslovi / tekst, sve sa Google Fonts): jakarta (Plus Jakarta Sans), inter (Inter), montserrat (Montserrat), jost (Jost), playfair (Playfair Display / DM Sans), lora (Lora / Figtree), cormorant (Cormorant Garamond / Manrope) i fraunces (Fraunces / Karla); nepoznat ključ tretirajte kao null. pitanja su česta pitanja koja je izdavalac sam uneo (najviše 10; pitanje do 150, odgovor do 600 znakova, odgovor može imati nove redove); prikažite ih tim redom. ponude su reklamni baneri akcija koje danas važe (najviše 3; posle roka do više ne stižu): istaknuto je krupan tekst (npr. "-15%", do 14 znakova) ili null, slika je pozadina banera ili null, cta tekst dugmeta (null = "Rezerviši"), sablon raspored (slika, podeljeno, kupon, boja), pozadina (brend, tamna, svetla), odbrojavanje znači da prikažete "Još N dana" do roka, a animacija je izbor izdavaoca: nema, odsjaj, nalepnica ili dugme. apartman_adresa je apartman na koji vodi dugme (vaša stranica /a/<apartman_adresa>), ili null: tada dugme vodi na spisak apartmana domaćina. dolazak i odlazak su termin boravka akcije (ili null); kad postoje, prikažite ih na baneru i dugmetom otvorite rezervaciju sa tim datumima. Akcija čiji je termin u međuvremenu zauzet (bar jedna noć u kalendaru tog apartmana) se ne vraća, a vraća se sama kad se termin oslobodi. Link akcije je možda podeljen ranije, pa pre označavanja datuma u kalendaru proverite da su slobodni. To je samo najava: akcijsku cenu domaćin podešava kod apartmana, pa je cena u jedinicama i pri rezervaciji već tačna. razlika_bookingje izdavaočeva tvrdnja koliko je isti boravak skuplji na Bookingu (1 do 50, u procentima), npr. "Na Bookingu oko 15% skuplje"; null znači da je ne prikazujete. Sve vrednosti su čist tekst: prikazujte ih kao tekst, nikad kao HTML.

Stranice označite sa noindex i canonical ka punoj strani apartmana. Kad superadmin označi da vaš sajt ima ove rute, gost365.app/a/... i /i/... preusmeravaju na vaš domen.

Jedna poseta brendirane stranice na vašem sajtu (/a/ ili /i/), za statistiku vlasnika. Šaljite je iz serverske rute vašeg sajta (ključ ne sme u pregledač), jednom po otvaranju stranice, najbolje iz klijentske komponente koja zove vašu rutu (roboti koji ne izvršavaju JavaScript se tako ne broje).

{ "vrsta": "a", "adresa": "apartman-marko" }

204 uvek, bez tela. Adresa koja ne pripada vašem nalogu se tiho ignoriše.

Slanje kontakt upita sa sajta. Vlasniku objekta se šalje email obaveštenje.

{
  "name": "Jovan Jovanović",      // obavezno
  "email": "jovan@email.com",     // obavezno
  "message": "Da li je slobodno u julu?",  // obavezno
  "phone": "+381641234567",       // opciono
  "type": "kontakt"               // opciono, podrazumevano "kontakt"
}

201 { "success": true, "message": "Upit je uspešno primljen." }

400 Polja name, email i message su obavezna. · 500 Greška pri čuvanju upita.

Dohvatanje definicije prilagođene forme koju je vlasnik napravio u Dashboard-u - koristite je da formu iscrtate na svom sajtu. Vraćaju se samo aktivne forme koje pripadaju vašem nalogu.

{
  "form": {
    "id": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",
    "name": "Zahtev za ponudu",
    "description": "Popunite za personalizovanu ponudu"
  },
  "fields": [
    {
      "label": "Broj osoba",
      "field_name": "broj_osoba",
      "field_type": "number",
      "placeholder": "npr. 4",
      "is_required": true,
      "options": null
    }
  ]
}

Polja stižu sortirana redosledom koji je vlasnik zadao. Polje options je niz stringova za polja tipa izbora, inače null.

404 Forma nije pronađena.

Slanje popunjene forme. Pored form_id, sva ostala polja iz tela zahteva se čuvaju kao odgovori - koristite field_name vrednosti iz prethodnog endpointa kao ključeve.

{
  "form_id": "3f2a1b0c-9d8e-7f6a-5b4c-3d2e1f0a9b8c",  // obavezno
  "broj_osoba": "4",
  "napomena": "Dolazimo sa psom"
}

201 { "success": true, "message": "Upit je uspešno primljen." }

400 form_id je obavezan. ili Podaci forme su prazni. · 404 Forma nije pronađena ili nije aktivna.

iCalendar (.ics) izvoz zauzetosti jedne jedinice, namenjen sinhronizaciji sa Booking.com, Airbnb i sličnim kanalima. Sadrži isključivo potvrđene rezervacije, sortirane po datumu početka, svaku kao celodnevni VEVENT.

Link sa tajnim tokenom vlasnik kopira u Dashboard-u (jedinica, "Sinhronizacija kalendara"). Token ne može da se izračuna ni pogodi i link radi uvek, i kada vlasnik isključi kalendar na sajtu za tu jedinicu.

Stariji oblik https://gost365.app/api/ical/{unitId} i dalje radi, ali samo za jedinice čija se zauzetost prikazuje na sajtu, jer je ID jedinice javan u GET /units. Za jedinicu sa isključenim kalendarom vraća 404, kao da ne postoji. Kanale zato povezujte linkom sa tokenom.

Ako vlasnik za jedinicu isključi sinhronizaciju sa Airbnb/Booking, oba oblika linka vraćaju 404 dok je ponovo ne uključi, a uvoz sa kanala za tu jedinicu staje.

Odgovor je text/calendar; charset=utf-8 uz Content-Disposition: attachment i onemogućeno keširanje.

404 običan tekst Smeštajna jedinica nije pronađena. - vraća se i kada token ili unitId nisu ispravni. 500 Greška na serveru. Greške ovog endpointa nisu u JSON formatu.