---
title: "API zdroje — Opening Hours for Laravel | Roundly"
description: "Hotové JSON resources pre aktuálny stav, upraviteľné definície, hodiny dňa a sloty — routy a controllery ostávajú na vás."
url: https://roundly-consulting.com/sk/open-source/navody/opening-hours-for-laravel/api-zdroje
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Opening Hours for Laravel](https://roundly-consulting.com/sk/open-source/navody/opening-hours-for-laravel.md)

# API zdroje

Balík neobsahuje routy ani controllery — endpointy sú vaše. Štyri JSON resources pokrývajú bežné výstupy:

```php
use RoundlyConsulting\OpeningHours\Facades\OpeningHours;
use RoundlyConsulting\OpeningHours\Http\Resources\CalendarResource;
use RoundlyConsulting\OpeningHours\Http\Resources\DayHoursResource;
use RoundlyConsulting\OpeningHours\Http\Resources\OpeningStatusResource;
use RoundlyConsulting\OpeningHours\Http\Resources\SlotResource;

return OpeningStatusResource::make(OpeningHours::for($clinic));         // status (optionally ->at($instant))
return CalendarResource::make(OpeningHours::calendar($clinic));         // editable definition
return DayHoursResource::collection(OpeningHours::for($clinic)->forWeekOf(now()));
return SlotResource::collection($slots);
```

## Tvar stavu

OpeningStatusResource vracia timezone, at, is\_open, current\_period, next\_open, next\_close, today, week (7 dní) a upcoming\_exceptions. Okamihy sú v ISO-8601 s posunom; preložené sú len weekday\_label a text (podľa jazyka aplikácie):

```json
{
  "timezone": "Europe/Bratislava",
  "at": "2026-09-26T12:00:00+02:00",
  "is_open": true,
  "current_period": {"start": "2026-09-26T09:00:00+02:00", "end": "2026-09-26T14:00:00+02:00",
                     "label": null, "start_unbounded": false, "end_unbounded": false},
  "next_open": "2026-09-28T08:00:00+02:00",
  "next_close": "2026-09-26T14:00:00+02:00",
  "today": {"date": "2026-09-26", "weekday": "saturday", "weekday_label": "Saturday", "closed": false,
            "all_day": false, "source": "schedule", "label": null,
            "ranges": [{"from": "09:00", "to": "14:00", "label": null, "capacity": null}], "text": "09:00–14:00"},
  "week": [ /* 7 day objects */ ],
  "upcoming_exceptions": [ {"date": "2026-12-24", "closed": true, "label": "Christmas", "ranges": []} ]
}
```

week obsahuje najbližších sedem dátumov (api.week\_mode = upcoming) alebo kalendárny týždeň od first\_day\_of\_week (calendar\_week). next\_open a next\_close sú null, ak sa v rámci search\_days nič nenájde.

## Upraviteľné definície

CalendarResource vracia kanonický vstup plus id, key, revision a updated\_at. Môžete ho bez úprav odoslať späť do OpeningHours::sync() — revision pošlite ako expectedRevision, aby ste zachytili súbežné úpravy:

```php
// GET — the editable definition, including its revision
return CalendarResource::make(OpeningHours::calendar($clinic));

// PUT — submit it back (edited or unchanged); the revision guards concurrent edits
OpeningHours::sync(
    $clinic,
    $request->validated('opening_hours'),
    expectedRevision: $request->integer('revision'),
);

// Status as of a given instant instead of now
return OpeningStatusResource::make(OpeningHours::for($clinic))->at($instant);
```

meta sa zobrazí len pri api.expose\_meta — a definícia odoslaná späť bez meta ho vymaže.

## Tvar dňa a slotu

- DayHoursResource — date, weekday, weekday\_label, closed, all\_day, source, label, ranges a text (plus meta, ak je zverejnené).
- SlotResource — start, end, available, remaining\_capacity a reason.

## Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

[Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

[Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/opening-hours-for-laravel.md)