Szabad időpontok a saját weboldaladon

A saját weboldaladon kilistázhatod egy szolgáltatás következő napokra eső szabad időpontjait, például napokra és napszakokra bontva (Holnap: délelőtt 9:30, délután 14:00, este 17:40). A vendég rákattint egy időpontra, a Bookinda foglaló már ezzel a szolgáltatással és időponttal nyílik meg, és csak az adatait kell megadnia.

Ezt a cikket a weboldalad fejlesztőjének érdemes továbbküldeni. Kulcs vagy bejelentkezés nem kell hozzá, a lekérdezés bármely weboldalról működik.

1. A szabad időpontok lekérése

GET https://api.bookinda.hu/api/public-availability/{szalon}/services/{szolgaltatas}/slots?days=7

• {szalon}: a foglalóoldalad címének első része. Ha a címed sajatnev.bookinda.hu, akkor sajatnev.
• {szolgaltatas}: a szolgáltatás azonosítója. Legegyszerűbb a Linkgenerátorból kimásolni: válaszd ki a szolgáltatást, és a kész linkben a services= utáni rész az azonosító.
• days: hány napot kérsz (1 és 14 között, alapból 7).
• staffId, locationId: ha csak egy munkatárs vagy egy helyszín időpontjai kellenek.
• source: rövid azonosító a weboldaladról (például sajatweboldal). A foglalás forrásánál ez látszik.

A válasz naponként sorolja az időpontokat:

{
  "onlineBookingEnabled": true,
  "tenant": { "name": "Példa Szalon", "timezone": "Europe/Budapest" },
  "service": { "name": "Zsírfagyasztás", "durationMinutes": 45, "priceMinor": 16000 },
  "days": [
    {
      "date": "2026-09-16",
      "weekday": 3,
      "slots": [
        { "time": "09:30", "iso": "2026-09-16T07:30:00.000Z", "bookingUrl": "https://..." }
      ]
    }
  ]
}

A zárt vagy teljesen betelt napok is benne vannak, üres slots listával. A választ legfeljebb 1 percig érdemes tárolni, hogy a friss foglalások gyorsan eltűnjenek belőle.

2. Foglalás egy kattintással

Minden időpontnál ott a kész bookingUrl. Ha erre visz a gomb, a foglaló kiválasztja a szolgáltatást és az időpontot, majd magától továbblép a vendég adataihoz.

Ha saját magad állítod össze a linket:

https://sajatnev.bookinda.hu/book?view=services&services=SZOLGALTATAS&date=2026-09-16&time=09:30&step=details

• date: a nap (ÉÉÉÉ-HH-NN).
• time: az időpont óra:perc alakban a szalonod időzónájában, vagy a válaszban kapott pontos iso érték.
• step=details: a kiválasztás után egyből az adatok megadása jön. Nélküle a vendég az időpontválasztón marad, és ő kattint a Tovább gombra.

Jó tudni

• Ugyanazokat az időpontokat látja, mint a foglalón. A lista a foglalóoldal számításából jön: munkaidő, meglévő foglalások, minimális előfoglalási idő, legkésőbbi foglalható nap és a szolgáltatás időkorlátai mind számítanak.
• Ha közben elkel az időpont. A foglaló jelzi, hogy a választott időpont már nem szabad, és ugyanazon a napon másikat választhat a vendég. Ha az adatok kitöltése közben foglalja le valaki más, a foglaló visszaviszi az időpontválasztáshoz, a megadott adatok megmaradnak.
• Kikapcsolt online foglalásnál a válaszban "onlineBookingEnabled": false áll, és nincsenek napok. Ilyenkor érdemes elrejteni a dobozt.
• Ami a szolgáltatáshoz még kell, az megmarad. Ha a szolgáltatásnak változatai vagy kiegészítői vannak, azok lépései az időpont előtt továbbra is megjelennek.
• Szoláriumnál nem működik. A szolárium szabad időpontjai a választott perctől és géptől függenek, ezért ott a lista nem érhető el, a foglalóoldalra linkelj.

Kapcsolódó cikkek

• Widget beágyazása a saját weboldaladra
• v2 widget, natív app-szerű foglalás a saját weboldalon
• Foglalási opciók, vendég-flow testreszabás