Dostupnost

Zjisteni dostupnych terminu pro rezervaci.

GET /:slug/availability

Vrati dostupne casove sloty pro zadany den.

Pozadavek

curl -X GET \
  -H "X-API-Key: vas_api_klic" \
  "https://api.zarezervujto.cz/api/v1/vas-projekt/availability?date=2024-12-15"

Query parametry

Parametr	Typ	Povinny	Popis
date	string	Ano	Datum ve formatu YYYY-MM-DD
branchId	string	Ne	ID pobocky
serviceId	string	Ne	ID sluzby
duration	number	Ne	Pozadovana delka v minutach

Odpoved

{
  "success": true,
  "date": "2024-12-15",
  "dayOfWeek": "Sunday",
  "isOpen": true,
  "openingHours": {
    "open": "09:00",
    "close": "18:00"
  },
  "slots": [
    {
      "from": "09:00",
      "to": "09:30",
      "available": true
    },
    {
      "from": "09:30",
      "to": "10:00",
      "available": true
    },
    {
      "from": "10:00",
      "to": "10:30",
      "available": false
    }
  ]
}

Popis poli

Pole	Typ	Popis
date	string	Datum
dayOfWeek	string	Den v tydnu (anglicky)
isOpen	boolean	Zda je otevreno
openingHours	object	Oteviraci doba
openingHours.open	string	Cas otevreni (HH:MM)
openingHours.close	string	Cas zavreni (HH:MM)
slots	array	Seznam casovych slotu
slots[].from	string	Zacatek slotu (HH:MM)
slots[].to	string	Konec slotu (HH:MM)
slots[].available	boolean	Zda je slot dostupny

Specialni pripady

Zavreno

{
  "success": true,
  "date": "2024-12-25",
  "dayOfWeek": "Wednesday",
  "isOpen": false,
  "reason": "Svatek - Vanoce",
  "slots": []
}

Pobocka s prestavkou

{
  "success": true,
  "date": "2024-12-15",
  "isOpen": true,
  "openingHours": {
    "open": "09:00",
    "close": "18:00",
    "breakStart": "12:00",
    "breakEnd": "13:00"
  },
  "slots": [...]
}

Priklad pouziti

async function getAvailability(slug, apiKey, date, options = {}) {
  const params = new URLSearchParams({ date });

  if (options.branchId) params.append('branchId', options.branchId);
  if (options.serviceId) params.append('serviceId', options.serviceId);
  if (options.duration) params.append('duration', options.duration);

  const response = await fetch(
    `https://api.zarezervujto.cz/api/v1/$:slug/availability?${params}`,
    {
      headers: { 'X-API-Key': apiKey }
    }
  );

  return response.json();
}

// Pouziti
const availability = await getAvailability('salon-krasy', 'zrt_live_...', '2024-12-15');

if (availability.isOpen) {
  const freeSlots = availability.slots.filter(s => s.available);
  console.log(`Dostupnych slotu: ${freeSlots.length}`);
} else {
  console.log('V tento den je zavreno');
}

GET /:slug/schedule

Vrati oteviraci dobu a svatky.

Pozadavek

curl -X GET \
  -H "X-API-Key: vas_api_klic" \
  https://api.zarezervujto.cz/api/v1/vas-projekt/schedule

Odpoved

{
  "success": true,
  "openingHours": [
    {
      "dayOfWeek": 1,
      "dayName": "Pondeli",
      "isOpen": true,
      "open": "09:00",
      "close": "18:00"
    },
    {
      "dayOfWeek": 2,
      "dayName": "Utery",
      "isOpen": true,
      "open": "09:00",
      "close": "18:00"
    },
    {
      "dayOfWeek": 0,
      "dayName": "Nedele",
      "isOpen": false
    }
  ],
  "holidays": [
    {
      "date": "2024-12-24",
      "name": "Stedry den",
      "isOpen": false
    },
    {
      "date": "2024-12-25",
      "name": "1. svatek vanocni",
      "isOpen": false
    }
  ]
}