API-documentatie

Genereer 800×480 BMP-afbeeldingen voor E-Ink-displays met F1-raceschema's in 1bit-, B/W/R- of Spectra 6-modus.

800×480 BMP 1bit / B/W/R / B/W/R/Y / Spectra 6 E-Ink REST API
GET /calendar.bmp

Genereert een F1-kalender als BMP-afbeelding (800×480) voor 1bit-, 4-bit B/W/R-, 4-bit B/W/R/Y- en Spectra 6 E-Ink-displays.

Parameters

Parameter Type Beschrijving
lang string Taalcode voor kalendertekst
Waarden: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (standaard: en)
year integer Seizoensjaar voor een specifieke race
optioneel — bijv. 2026
round integer Rondenummer (1-24) voor een specifieke race
optioneel — bijv. 5
tz string Tijdzone voor tijden in het schema (IANA-formaat)
optioneel — bijv. America/New_York, Europe/Prague
display string Uitvoermodus voor 1bit-, B/W/R-, B/W/R/Y- of Spectra 6-displays
Waarden: 1bit, bwr, bwry, spectra6 (standaard: 1bit)
weather boolean Weeroverlay in- of uitschakelen
Waarden: true, false
weather_type string Welke variant van weergegevens gerenderd moet worden
Waarden: race_day, current

Respons

Content-Type image/bmp
Afmetingen 800×480
Kleurdiepte 1bit / 4-bit B/W/R / 4-bit B/W/R/Y / Spectra 6
Cache 1 hour

Codevoorbeelden

# Download next race calendar
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp"

# With Czech language and timezone
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp?lang=cs&tz=Europe/Prague"

# Specific race (year and round)
curl -o calendar.bmp "https://f1.inkycloud.click/calendar.bmp?year=2025&round=5"

# B/W/R/Y output for four-color E-Ink
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"):
    """Download F1 calendar as BMP image."""
    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("Calendar saved as calendar.bmp")

# Usage
import asyncio
asyncio.run(get_f1_calendar(lang="cs"))
// Fetch and display calendar
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();

    // Display in img element
    const img = document.getElementById('calendar');
    img.src = URL.createObjectURL(blob);
}

// Download as file
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();
}

Gebruik op E-Ink-display

Haal /calendar.bmp op en toon het direct op uw E-Ink-display. Aanbevolen verversingsinterval: elke 1 tot 6 uur. Compatibel met elk 800×480 E-Ink-display (bijv. Waveshare 7.5", LaskaKit).

Voor LaskaKit / zivyobraz.eu:

  1. 1 Selecteer in zivyobraz.eu als contentbron: URL met afbeelding
  2. 2 Plak de URL: https://f1.inkycloud.click/calendar.bmp?lang=cs&tz=Europe/Prague
  3. 3 Stel het vernieuwingsinterval in op 1-6 uur
GET /teams.bmp

Genereer een BMP-afbeelding met alle F1-teams, hun coureurs, foto's en kampioenschapspunten in 1bit-, B/W/R-, B/W/R/Y- of Spectra 6-uitvoermodus.

Parameters

Parameter Type Beschrijving
lang string Taalcode voor kalendertekst
Waarden: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (standaard: en)
year integer Seizoensjaar voor teamdata
optioneel — bijv. 2026
display string Uitvoermodus van het display
Waarden: 1bit, bwr, bwry, spectra6 (standaard: 1bit)

Respons

Content-Type image/bmp
Afmetingen 800×480
Kleurdiepte 1-bit / 4-bit / Spectra 6
Cache no-store

Andere endpoints

GET /api/teams/{year}

Alle teams met coureurs en punten voor een seizoen ophalen (JSON)

GET /api/standings/leader

Huidige kampioenschapsleiders ophalen (coureur en constructeur)

GET /api/races/{year}

Lijst van alle races voor een seizoen

GET /api/race/{year}/{round}

Gedetailleerde race-informatie inclusief schema

GET /api/stats

Aanvraagstatistieken (laatste uur en 24 u)

GET /health

Service health-check

GET /api

JSON API — API-documentatie in JSON-formaat