Pre vývojárov

Developer Hub

Integrujte dáta z Novej Osmičky do svojich aplikácií. Verejné API a RSS kanály sú k dispozícii zdarma a bez nutnosti registrácie.

Public API v1

REST API s endpointmi pre akcie, články, kategórie, tagy, lokality a organizácie.

RSS kanály

RSS 2.0 kanály pre články a nadchádzajúce akcie v 4 jazykoch.

REST API

Public API v1

Základná URL

https://www.novaosmicka.cz/api/v1/

Obmedzenie počtu požiadaviek

API je obmedzené na 3 600 požiadaviek za deň na jednu IP adresu. Pri prekročení limitu bude vrátený HTTP status 429.

Spoločné parametre

Stránkovanie

Parameter Typ Predvolené Popis
per_page integer 15 Počet položiek na stránku (1–100)
page integer 1 Číslo stránky

Jazyk

Parameter Typ Predvolené Popis
lang string cs Kód jazyka: cs, sk, en, pl. Ovplyvňuje preklady názvov a popisov.

Štruktúra odpovedí

Zoznam (kolekcia)

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 15,
    "total": 73
  },
  "links": {
    "first": "...?page=1",
    "last": "...?page=5",
    "prev": null,
    "next": "...?page=2"
  }
}

Jednotlivý záznam

{
  "success": true,
  "data": { ... }
}

Chybová odpoveď (404)

{
  "success": false,
  "message": "Resource not found"
}

Akcie

GET /api/v1/events

Vráti stránkovaný zoznam publikovaných akcií zoradených podľa dátumu.

Ďalšie parametre
date_from string (YYYY-MM-DD) Filtrovať akcie od dátumu (YYYY-MM-DD)
date_to string (YYYY-MM-DD) Filtrovať akcie do dátumu (YYYY-MM-DD)
category_id integer Filtrovať podľa ID kategórie
upcoming string Iba nadchádzajúce akcie (hodnota "true")
Príklad
curl -s "https://www.novaosmicka.cz/api/v1/events?upcoming=true&lang=en&per_page=5"
GET /api/v1/events/{id_or_slug}

Vráti detail akcie podľa ID alebo slugu. Zahŕňa vstupenky a harmonogram.

Schéma odpovede
{
  "id": 42,
  "slug": "summer-festival-2026",
  "name": "Summer Festival 2026",
  "description": "...",
  "short_description": "...",
  "date_from": "2026-07-15",
  "date_to": "2026-07-17",
  "time_from": "18:00",
  "time_to": "23:00",
  "status": "published",
  "cancelled_at": null,
  "cancellation_reason": null,
  "price": 350,
  "admission_mode": "free_reservation",
  "reservation_capacity": 100,
  "reservation_remaining": 42,
  "reservation_opens_at": "2026-06-01T00:00:00+00:00",
  "reservation_closes_at": "2026-07-15T18:00:00+00:00",
  "is_reserved_by_me": false,
  "banner_url": "https://...",
  "tickets_url": "https://...",
  "facebook_event_url": "https://...",
  "category": { "id": 1, "slug": "koncerty", "name": "Koncerty" },
  "tags": [{ "id": 1, "slug": "rock", "name": "Rock", "color": "#ff0000" }],
  "organisator": { "id": 1, "slug": "nova-osmicka", "name": "Nová Osmička" },
  "location": { "id": 3, "name": "Hlavní sál", "description": "...", "tag": "indoor", "type": "location", "position": { "lat": 49.68, "lng": 18.35 } },
  "tickets": [{ "id": 1, "name": "Standard", "price": 350, "is_sold_out": false }],
  "timetable": [{ "id": 1, "name": "Opening act", "datetime_from": "2026-07-15T18:00:00", "datetime_to": "2026-07-15T19:00:00", "location_id": 3 }]
}

Články

GET /api/v1/articles

Vráti stránkovaný zoznam publikovaných článkov zoradených podľa dátumu publikácie.

GET /api/v1/articles/{id_or_slug}

Vráti detail článku podľa ID alebo slugu.

Schéma odpovede
{
  "id": 12,
  "slug": "new-season-opening",
  "title": "New Season Opening",
  "text": "...",
  "short_text": "...",
  "banner_url": "https://...",
  "article_tag": "news",
  "publish_date": "2026-01-15T10:00:00.000000Z"
}

Kategórie

GET /api/v1/categories

Vráti stránkovaný zoznam kategórií akcií.

GET /api/v1/categories/{id}

Vráti detail kategórie podľa ID.

Schéma odpovede
{
  "id": 1,
  "slug": "koncerty",
  "name": "Koncerty"
}

Tagy

GET /api/v1/tags

Vráti stránkovaný zoznam tagov.

GET /api/v1/tags/{id}

Vráti detail tagu podľa ID.

Schéma odpovede
{
  "id": 1,
  "slug": "rock",
  "name": "Rock",
  "color": "#ff0000"
}

Lokality

GET /api/v1/locations

Vráti stránkovaný zoznam verejných lokalít v areáli.

GET /api/v1/locations/{id}

Vráti detail verejnej lokality podľa ID.

Schéma odpovede
{
  "id": 3,
  "name": "Hlavní sál",
  "description": "...",
  "tag": "indoor",
  "type": "location",
  "position": {
    "lat": 49.6833,
    "lng": 18.3500
  }
}

Organizácie

GET /api/v1/organisations

Vráti stránkovaný zoznam organizácií. Nepodporuje parameter lang.

GET /api/v1/organisations/{id_or_slug}

Vráti detail organizácie podľa ID alebo slugu.

Schéma odpovede
{
  "id": 1,
  "slug": "nova-osmicka",
  "name": "Nová Osmička",
  "email": "info@novaosmicka.cz",
  "short_description": "...",
  "long_description": "...",
  "icon_url": "https://...",
  "website": "https://www.novaosmicka.cz",
  "social": {
    "facebook": "https://...",
    "instagram": "https://...",
    "twitter": null,
    "youtube": "https://...",
    "linkedin": null
  }
}

RSS kanály

RSS kanály

Odoberajte novinky a program Novej Osmičky prostredníctvom RSS čítačky.

Novinky

Posledných 50 publikovaných článkov.

https://www.novaosmicka.cz/rss/articles.xml

Program

50 nadchádzajúcich akcií zoradených chronologicky.

https://www.novaosmicka.cz/rss/events.xml

Viacjazyčné kanály

Kanály sú dostupné v štyroch jazykoch. Predvolená (bez prefixu) je čeština.

Czech (default):  /rss/articles.xml       /rss/events.xml
English:          /en/rss/articles.xml    /en/rss/events.xml
Slovak:           /sk/rss/articles.xml    /sk/rss/events.xml
Polish:           /pl/rss/articles.xml    /pl/rss/events.xml

Technické detaily

  • ■ Formát: RSS 2.0 s Atom self-linkom
  • ■ Cache: 1 hodina (Cache-Control: public, max-age=3600)
  • ■ Automatické nájdenie: link tagy sú v HTML hlavičke každej stránky
  • ■ Články: posledných 50 položiek
  • ■ Akcie: 50 najbližších nadchádzajúcich akcií
Príklad
curl -s "https://www.novaosmicka.cz/en/rss/articles.xml"