Dokumentace API
Generování 800×480 BMP obrázků pro E-Ink displeje zobrazující harmonogramy závodů F1 v režimu 1bit, B/W/R, B/W/R/Y nebo Spectra 6.
GET
/calendar.bmp
Generuje F1 kalendář jako BMP obrázek (800×480) pro 1bit, 4bit B/W/R, 4bit B/W/R/Y a Spectra 6 E-Ink displeje.
Bez kombinace year a round nebo race_key se vybere nejbližší závod. Hodnotu round nebo race_key zkopírujte z /api/races/{year}. Výjimka: race_key bez year vrací HTTP 400.
Styl tratě: track_style=relief · Podklad tratě: track_source=jules · Barevné akcenty: track_accent=all.
Výška a barevné úseky jsou dekorativní. Použijí se barvy podporované displejem. Pro všechny čtyři akcenty použijte display=spectra6.
GET /api/tracks — Všechny styly, barvy a tratě. GET /api/tracks/{circuit_id} — Autoři a licence.
GET /api/tracks/{circuit_id}.{svg|png|bmp} · GET /preview/configure/calendar.png — Stejné parametry track_style, track_source, track_accent.
Parametry
| Parameter | Typ | Popis |
|---|---|---|
| lang | string |
Kód jazyka pro text kalendáře
Hodnoty: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (výchozí:
en)
|
| year | integer |
Rok sezóny pro konkrétní závod
volitelný — např. 2026
|
| round | integer |
Číslo kola ze seznamu závodů sezóny; bez year se ignoruje
volitelný — např. ?year=2026&round=5
|
| race_key | string |
Identifikátor závodu z /api/races/{year}; vyžaduje year
volitelný — např. 2026-round-6-monaco-2026-06-07
|
| tz | string |
Časové pásmo pro časy v harmonogramu (IANA formát)
volitelný — např. America/New_York,
Europe/Prague
(výchozí: Europe/Prague)
|
| display | string |
Režim výstupu pro 1bit, B/W/R, B/W/R/Y nebo Spectra 6 displeje
Hodnoty: 1bit,
bwr,
bwry,
spectra6 (výchozí:
1bit)
|
| weather | boolean |
Zapnutí nebo vypnutí překrytí s počasím
Hodnoty: true,
false
(výchozí: true)
|
| weather_type | string |
Typ zobrazených dat o počasí
Hodnoty: off,
race_day,
race,
current
(výchozí: race_day)
|
| track_style | string |
Styl tratě
Hodnoty: relief, poster, clean, lino, riso, screenprint, contours, geometric, blueprint, ribbon, mosaic, halftone, negative, papercut, typographic, artdeco, stencil, pixel
(výchozí: relief)
|
| track_source | string |
Podklad tratě
Hodnoty: jules, commons
(výchozí: jules)
|
| track_accent | string |
Barevné akcenty
Hodnoty: all, mono, red, yellow, blue, green, warm, red-blue, red-green, yellow-blue, yellow-green, cool, red-yellow-blue, red-yellow-green, red-blue-green, yellow-blue-green
(výchozí: all)
|
Odpověď
image/bmp
800×480
1bit / 4-bit B/W/R / 4-bit B/W/R/Y / Spectra 6
public, max-age=3600
Odpovědi s BMP obsahují ETag. Odešlete If-None-Match a při nezměněném obrázku obdržíte 304.
Ukázky kódu
# Stáhnout kalendář dalšího závodu
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp"
# S českým jazykem a časovým pásmem
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp?lang=cs&tz=Europe/Prague"
# Konkrétní závod (rok a kolo)
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp?year=2026&round=6"
# B/W/R/Y varianta pro černo-bílo-červeno-žlutý e-paper
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp?display=bwry"
import httpx
async def get_f1_calendar(lang: str = "en", tz: str = "Europe/Prague"):
"""Stáhne F1 kalendář jako BMP obrázek."""
async with httpx.AsyncClient() as client:
response = await client.get(
"https://f1.inkycloud.click/calendar.bmp",
params={"lang": lang, "tz": tz}
)
response.raise_for_status()
with open("calendar.bmp", "wb") as f:
f.write(response.content)
print("Kalendář uložen jako calendar.bmp")
# Použití
import asyncio
asyncio.run(get_f1_calendar(lang="cs"))
// Načíst a zobrazit kalendář
async function loadF1Calendar(lang = 'en', tz = 'Europe/Prague') {
const url = new URL('https://f1.inkycloud.click/calendar.bmp');
url.searchParams.set('lang', lang);
url.searchParams.set('tz', tz);
const response = await fetch(url);
const blob = await response.blob();
// Zobrazit v img elementu
const img = document.getElementById('calendar');
img.src = URL.createObjectURL(blob);
}
// Stáhnout jako soubor
async function downloadCalendar() {
const response = await fetch('/calendar.bmp?lang=cs');
const blob = await response.blob();
const link = document.createElement('a');
link.href = URL.createObjectURL(blob);
link.download = 'f1-calendar.bmp';
link.click();
}
Použití s E-Ink displejem
Načtěte /calendar.bmp a zobrazte přímo na E-Ink displeji. Doporučený interval obnovy: každé 1-6 hodin. Kompatibilní s libovolným 800×480 E-Ink displejem (např. Waveshare 7.5", LaskaKit).
Pro LaskaKit / zivyobraz.eu:
- 1 V zivyobraz.eu vyberte jako zdroj obsahu: URL s obrázkem
-
2
Vložte URL:
https://f1.inkycloud.click/calendar.bmp?lang=cs&tz=Europe/Prague - 3 Nastavte interval obnovování na 1-6 hodin
GET
/teams.bmp
Generování BMP obrázku se všemi F1 týmy, jejich jezdci, fotkami a body v šampionátu v režimech 1bit, B/W/R, B/W/R/Y nebo Spectra 6.
Atribuce a licence obrázku (kresby tratí CC BY 4.0, počasí Open-Meteo CC BY 4.0): viz Credits. Odpovědi obsahují i hlavičku Link s rel="license".
Parametry
| Parameter | Typ | Popis |
|---|---|---|
| lang | string |
Kód jazyka pro text kalendáře
Hodnoty: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (výchozí:
en)
|
| year | integer |
Rok sezóny pro data týmů
volitelný — např. 2026
|
| display | string |
Režim výstupu pro displej
Hodnoty: 1bit,
bwr,
bwry,
spectra6 (výchozí:
1bit)
|
| extra | string | Volitelný panel: none (výchozí), countdown, flags, track, weather. Používá místní data sezóny a počasí z mezipaměti; nedostupný panel se nezobrazí. |
| tz | string | Optional IANA timezone for extra panels showing a time or date: countdown, flags, track, weather. Defaults to the server's DEFAULT_TIMEZONE; ignored for none or unavailable panels. Invalid values return HTTP 400. Also supported by /preview/configure/teams.png. |
Odpověď
image/bmp
800×480
1-bit / 4-bit / Spectra 6
no-cache
Další endpointy
/api/teams/{year}
Získat všechny týmy s jezdci a body pro sezónu (JSON)
/api/standings/leader
Získat aktuální lídry šampionátu (jezdec a konstruktér)
/api/standings/leader/{year}
/api/races/{year}
Seznam všech závodů pro danou sezónu
/api/race/{year}/{round}
Detailní informace o konkrétním závodě včetně harmonogramu
/api/stats
Statistiky požadavků za posledních 24 hodin
GET /api/stats/history
Historie požadavků po hodinách; limit: 1–720 (výchozí 168).
GET / POST /api/perf-metrics
GET: souhrny výkonu; hours: 1–720 (výchozí 24). POST: číselné metriky Web Vitals; metadata návštěvníků a zařízení se ignorují.
GET /preview/{screen_type}.png
GET /preview/configure/{screen_type}.png
PNG náhledy kalendáře nebo týmů; lang vybírá jazyk. Konfigurační náhledy přijímají také display a pro kalendář weather_type (výchozí off).
extra — Volitelný panel: none (výchozí), countdown, flags, track, weather. Používá místní data sezóny a počasí z mezipaměti; nedostupný panel se nezobrazí.
track_style, track_source, track_accent — Styl tratě, Podklad tratě, Barevné akcenty (calendar).
GET /health/ready
Databáze, zapisovatelné úložiště a aktuálnost obrázků; HTTP 200 při připravenosti, jinak 503.
/health
Kontrola zdraví služby
API pro čtení statistik vyžadují X-Admin-Token nebo Authorization: Bearer <token>, pokud je nastaven ADMIN_API_TOKEN. Při MINIMAL_DATA_MODE=true vracejí všechna statistická API stav 410.
Požadavky překračující limit četnosti vracejí 429 s hlavičkou Retry-After.