Pro vývojáře

Developer Hub

Integrujte data z Nové Osmičky do svých aplikací. Veřejné API a RSS kanály jsou k dispozici zdarma a bez nutnosti registrace.

Public API v1

REST API s endpointy pro akce, články, kategorie, tagy, lokace a organizace.

RSS kanály

RSS 2.0 kanály pro články a nadcházející akce ve 4 jazycích.

REST API

Public API v1

Základní URL

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

Omezení počtu požadavků

API je omezeno na 3 600 požadavků za den na jednu IP adresu. Při překročení limitu bude vrácen HTTP status 429.

Společné parametry

Stránkování

Parametr Typ Výchozí Popis
per_page integer 15 Počet položek na stránku (1–100)
page integer 1 Číslo stránky

Jazyk

Parametr Typ Výchozí Popis
lang string cs Kód jazyka: cs, sk, en, pl. Ovlivňuje překlady názvů a popisů.

Struktura odpovědí

Seznam (kolekce)

{
  "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á odpověď (404)

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

Akce

GET /api/v1/events

Vrátí stránkovaný seznam publikovaných akcí seřazených podle data.

Další parametry
date_from string (YYYY-MM-DD) Filtrovat akce od data (YYYY-MM-DD)
date_to string (YYYY-MM-DD) Filtrovat akce do data (YYYY-MM-DD)
category_id integer Filtrovat podle ID kategorie
upcoming string Pouze nadcházející akce (hodnota "true")
Pří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átí detail akce podle ID nebo slugu. Zahrnuje vstupenky a harmonogram.

Schéma odpovědi
{
  "id": "uuid",
  "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",
  "price": 350,
  "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": "uuid", "slug": "nova-osmicka", "name": "Nová Osmička" },
  "location": { "id": "uuid", "name": "Hlavní sál", "description": "...", "tag": "...", "type": "...", "position": { "lat": 49.68, "lng": 18.35 } },
  "tickets": [{ "id": "uuid", "name": "Standard", "price": 350 }],
  "timetable": [{ "id": "uuid", "name": "Opening act", "datetime_from": "2026-07-15T18:00:00", "datetime_to": "2026-07-15T19:00:00", "location_id": "uuid" }]
}

Články

GET /api/v1/articles

Vrátí stránkovaný seznam publikovaných článků seřazených podle data publikace.

GET /api/v1/articles/{id_or_slug}

Vrátí detail článku podle ID nebo slugu.

Schéma odpovědi
{
  "id": "uuid",
  "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"
}

Kategorie

GET /api/v1/categories

Vrátí stránkovaný seznam kategorií akcí.

GET /api/v1/categories/{id}

Vrátí detail kategorie podle ID.

Schéma odpovědi
{
  "id": 1,
  "slug": "koncerty",
  "name": "Koncerty"
}

Tagy

GET /api/v1/tags

Vrátí stránkovaný seznam tagů.

GET /api/v1/tags/{id}

Vrátí detail tagu podle ID.

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

Lokace

GET /api/v1/locations

Vrátí stránkovaný seznam veřejných lokací v areálu.

GET /api/v1/locations/{id}

Vrátí detail veřejné lokace podle ID.

Schéma odpovědi
{
  "id": "uuid",
  "name": "Hlavní sál",
  "description": "...",
  "tag": "indoor",
  "type": "hall",
  "position": {
    "lat": 49.6833,
    "lng": 18.3500
  }
}

Organizace

GET /api/v1/organisations

Vrátí stránkovaný seznam organizací. Nepodporuje parametr lang.

GET /api/v1/organisations/{id_or_slug}

Vrátí detail organizace podle ID nebo slugu.

Schéma odpovědi
{
  "id": "uuid",
  "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

Odebírejte novinky a program Nové Osmičky prostřednictvím RSS čtečky.

Novinky

Posledních 50 publikovaných článků.

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

Program

50 nadcházejících akcí seřazených chronologicky.

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

Vícejazyčné kanály

Kanály jsou dostupné ve čtyřech jazycích. Výchozí (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-link
  • ■ Cache: 1 hodina (Cache-Control: public, max-age=3600)
  • ■ Automatické nalezení: link tagy jsou v HTML hlavičce každé stránky
  • ■ Články: posledních 50 položek
  • ■ Akce: 50 nejbližších nadcházejících akcí
Příklad
curl -s "https://www.novaosmicka.cz/en/rss/articles.xml"