Dla programistów

Developer Hub

Zintegruj dane z Nové Osmičky ze swoimi aplikacjami. Publiczne API i kanały RSS są dostępne bezpłatnie i bez rejestracji.

Public API v1

REST API z endpointami dla wydarzeń, artykułów, kategorii, tagów, lokalizacji i organizacji.

Kanały RSS

Kanały RSS 2.0 z artykułami i nadchodzącymi wydarzeniami w 4 językach.

REST API

Public API v1

Podstawowy adres URL

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

Limit zapytań

API jest ograniczone do 3 600 zapytań dziennie na jeden adres IP. Po przekroczeniu limitu zostanie zwrócony status HTTP 429.

Parametry wspólne

Paginacja

Parametr Typ Domyślnie Opis
per_page integer 15 Liczba elementów na stronę (1–100)
page integer 1 Numer strony

Język

Parametr Typ Domyślnie Opis
lang string cs Kod języka: cs, sk, en, pl. Wpływa na tłumaczenia nazw i opisów.

Struktura odpowiedzi

Lista (kolekcja)

{
  "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"
  }
}

Pojedynczy rekord

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

Odpowiedź z błędem (404)

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

Wydarzenia

GET /api/v1/events

Zwraca stronicowaną listę opublikowanych wydarzeń posortowanych według daty.

Dodatkowe parametry
date_from string (YYYY-MM-DD) Filtruj wydarzenia od daty (YYYY-MM-DD)
date_to string (YYYY-MM-DD) Filtruj wydarzenia do daty (YYYY-MM-DD)
category_id integer Filtruj według ID kategorii
upcoming string Tylko nadchodzące wydarzenia (wartość "true")
Przykład
curl -s "https://www.novaosmicka.cz/api/v1/events?upcoming=true&lang=en&per_page=5"
GET /api/v1/events/{id_or_slug}

Zwraca szczegóły wydarzenia według ID lub sluga. Zawiera bilety i harmonogram.

Schemat odpowiedzi
{
  "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 }]
}

Artykuły

GET /api/v1/articles

Zwraca stronicowaną listę opublikowanych artykułów posortowanych według daty publikacji.

GET /api/v1/articles/{id_or_slug}

Zwraca szczegóły artykułu według ID lub sluga.

Schemat odpowiedzi
{
  "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"
}

Kategorie

GET /api/v1/categories

Zwraca stronicowaną listę kategorii wydarzeń.

GET /api/v1/categories/{id}

Zwraca szczegóły kategorii według ID.

Schemat odpowiedzi
{
  "id": 1,
  "slug": "koncerty",
  "name": "Koncerty"
}

Tagi

GET /api/v1/tags

Zwraca stronicowaną listę tagów.

GET /api/v1/tags/{id}

Zwraca szczegóły tagu według ID.

Schemat odpowiedzi
{
  "id": 1,
  "slug": "rock",
  "name": "Rock",
  "color": "#ff0000"
}

Lokalizacje

GET /api/v1/locations

Zwraca stronicowaną listę publicznych lokalizacji na terenie obiektu.

GET /api/v1/locations/{id}

Zwraca szczegóły publicznej lokalizacji według ID.

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

Organizacje

GET /api/v1/organisations

Zwraca stronicowaną listę organizacji. Nie obsługuje parametru lang.

GET /api/v1/organisations/{id_or_slug}

Zwraca szczegóły organizacji według ID lub sluga.

Schemat odpowiedzi
{
  "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
  }
}

Kanały RSS

Kanały RSS

Subskrybuj aktualności i program Nové Osmičky za pomocą czytnika RSS.

Aktualności

Ostatnie 50 opublikowanych artykułów.

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

Program

50 nadchodzących wydarzeń w porządku chronologicznym.

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

Kanały wielojęzyczne

Kanały są dostępne w czterech językach. Domyślny (bez prefiksu) to czeski.

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

Szczegóły techniczne

  • ■ Format: RSS 2.0 z linkiem Atom self
  • ■ Cache: 1 godzina (Cache-Control: public, max-age=3600)
  • ■ Automatyczne wykrywanie: tagi link w nagłówku HTML każdej strony
  • ■ Artykuły: ostatnie 50 pozycji
  • ■ Wydarzenia: 50 najbliższych nadchodzących wydarzeń
Przykład
curl -s "https://www.novaosmicka.cz/en/rss/articles.xml"