Program festiwalu Nowe Horyzonty w JSON

Udostępniamy publiczne API w formacie JSON, zawierające aktualny program festiwalu. Może się ono przydać osobom z zacięciem programistycznym, które chciałyby stworzyć własną aplikację do przeglądania programu, planowania festiwalowego kalendarza lub wykorzystać dane w innym projekcie.

Za pomocą API można pobierać informacje o sekcjach, filmach, koncertach i seansach.

Endpoint

Adres: https://www.nowehoryzonty.pl/open-api/program
Metoda: GET
Format: JSON (UTF-8)
Zakres danych: zawsze aktualna edycja festiwalu
Aktualizacja: dane są buforowane i odświeżane co ok. 5 minut

Struktura odpowiedzi

Obiekt główny zawiera metadane oraz dwie listy — sekcje i tytuly:

desc — opis źródła danych
edycja — numer edycji festiwalu
version — wersja API (aktualnie 2.1)
docs — adres tej dokumentacji
sekcje — pełna lista sekcji programu (definicje)
tytuly — lista tytułów wraz z seansami

Sekcja (element listy sekcje):
id, slug, skrot, nazwa, kolor, lp (kolejność), www (pełny adres strony sekcji).

Tytuł (element listy tytuly):

id, film (czy to film), slug
tytulPl, tytulEn, tytulOrg — tytuły
rezyser, rok, kraj, rodzaj, czasTrwania (w minutach) — dane opisowe (np. dla wydarzeń i koncertów część z nich bywa pominięta)
glownaSekcja — nazwa głównej sekcji tytułu
sekcje — sekcje, w których występuje tytuł; każdy wpis: id (odwołanie do listy sekcji), nazwa, lpTytuluWSekcji (klucz sortowania w sekcji), glowna (true dla sekcji głównej)
fotos — grafiki (pełne adresy URL): nazwaPliku, nazwaPlikuKafel
seanse — lista seansów stacjonarnych
online — dostępność online (patrz niżej)
www — pełny adres strony tytułu
zestaw, zestawTytulem, czasTrwaniaZestawu, filmyWZestawie — dla zestawów krótkich metraży (filmyWZestawie zawiera tytuły składowe)

Seans (element listy seanse):
eventId, sala, dataCzas (format dd-MM-yyyy HH:mm), qa (true, gdy zaplanowano spotkanie z gośćmi), gala (true dla gal). Pola qa i gala pojawiają się tylko, gdy są prawdziwe.

Dostępność online (element listy online):
seanse online nie są wypisywane na liście seanse — zamiast tego przy tytule podajemy okno dostępności: eventId, od i do (format dd-MM-yyyy HH:mm).

Uwaga: pola puste lub nieistotne są pomijane w odpowiedzi, a wszystkie adresy (www, grafiki) to pełne, bezwzględne URL-e.

Przykład

{
  "desc": "Program festiwalu NH",
  "edycja": 26,
  "version": "2.1",
  "docs": "https://www.nowehoryzonty.pl/open-api",
  "sekcje": [
    { "id": 1331, "slug": "klub-festiwalowy", "skrot": "Klub festiwalowy w Arsenale", "nazwa": "Klub festiwalowy w Arsenale", "kolor": "#1AAA6A", "lp": 35, "www": "https://www.nowehoryzonty.pl/program/index/26/klub-festiwalowy" }
  ],
  "tytuly": [
    {
      "id": 15088,
      "film": false,
      "slug": "ho99o9",
      "rodzaj": "wydarzenie",
      "tytulPl": "Ho99o9",
      "tytulEn": "Ho99o9",
      "tytulOrg": "Ho99o9",
      "zestaw": false,
      "glownaSekcja": "Klub festiwalowy w Arsenale",
      "czasTrwania": 60.00,
      "fotos": {
        "nazwaPliku": "https://www.nowehoryzonty.pl/pliki/wgrane/image/26nh/katalog/2026/HO99O9/glw_..._standa.jpg",
        "nazwaPlikuKafel": "https://www.nowehoryzonty.pl/pliki/wgrane/image/26nh/katalog/2026/HO99O9/glw_..._kafel.jpg"
      },
      "sekcje": [ { "id": 1331, "nazwa": "Klub festiwalowy w Arsenale", "lpTytuluWSekcji": 13217, "glowna": true } ],
      "seanse": [ { "eventId": 106914, "sala": "Klub festiwalowy w Arsenale", "dataCzas": "25-07-2026 22:30" } ],
      "www": "https://www.nowehoryzonty.pl/program/26/ho99o9"
    }
  ]
}

Warunki użycia

Dane mają charakter informacyjny, a program festiwalu może ulegać zmianom — pobieraj je na bieżąco. W razie pytań pisz na admin@nowehoryzonty.pl.

Historia wersji

Wersja 1 — lipiec 2025. Pierwsza publiczna wersja API programu.
Wersja 2.1— 7 lipca 2026. Najważniejsze zmiany:
- Dodano dostępność online przy tytule (lista online z oknem od–do); seanse online nie są już wypisywane na liście seanse.
- Dodano w obiekcie głównym pola edycja, version i docs.
- Adresy www oraz grafiki (fotos) są teraz pełnymi, bezwzględnymi URL-ami.
- Dodano www w sekcjach; przy tytule w sekcje pojawiły się lpTytuluWSekcji i glowna.
- Zmieniono nazwę pola sekcja na glownaSekcja (przy tytule).
- Usunięto pole sekcjaSlug z tytułu oraz flagę online z pojedynczego seansu.
- Pola puste (np. rok, kraj, rezyser) oraz qa/gala bez wartości są pomijane.