API Dokümantasyonu
1bit, B/W/R, B/W/R/Y veya Spectra 6 modunda F1 yarış takvimlerini gösteren E-Ink ekranlar için 800×480 BMP görseller oluşturun.
GET
/calendar.bmp
F1 takvimini BMP görseli (800×480) olarak üretir ve 1bit, 4-bit B/W/R, 4-bit B/W/R/Y ve Spectra 6 E-Ink ekranları destekler.
year ile round veya race_key birlikte belirtilmezse sıradaki yarış seçilir. round veya race_key değerini /api/races/{year} kaynağından kopyalayın. İstisna: year olmadan race_key HTTP 400 döndürür.
Pist stili: track_style=relief · Harita kaynağı: track_source=jules · Renk vurguları: track_accent=all.
Yükseklik ve renkli bölümler dekoratiftir. Ekranınızın desteklediği renkler kullanılır. Dört vurgu rengi için kullanın display=spectra6.
GET /api/tracks — Tüm stiller, renkler ve pistler. GET /api/tracks/{circuit_id} — Yazarlar ve lisanslar.
GET /api/tracks/{circuit_id}.{svg|png|bmp} · GET /preview/configure/calendar.png — Aynı track_style, track_source, track_accent parametreleri.
Parametreler
| Parameter | Tür | Açıklama |
|---|---|---|
| lang | string |
Takvim metni için dil kodu
Değerler: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (varsayılan:
en)
|
| year | integer |
Belirli yarış için sezon yılı
opsiyonel — örn. 2026
|
| round | integer |
Sezon yarış listesindeki tur numarası; year olmadan yok sayılır
opsiyonel — örn. ?year=2026&round=5
|
| race_key | string |
/api/races/{year} kaynağından yarış tanımlayıcısı; year gerektirir
opsiyonel — örn. 2026-round-6-monaco-2026-06-07
|
| tz | string |
Takvim saatleri için saat dilimi (IANA biçimi)
opsiyonel — örn. America/New_York,
Europe/Prague
(varsayılan: Europe/Prague)
|
| display | string |
1bit, B/W/R, B/W/R/Y veya Spectra 6 ekranlar için çıktı modu
Değerler: 1bit,
bwr,
bwry,
spectra6 (varsayılan:
1bit)
|
| weather | boolean |
Hava durumu katmanını aç veya kapat
Değerler: true,
false
(varsayılan: true)
|
| weather_type | string |
Hangi hava durumu verisi varyantının çizileceği
Değerler: off,
race_day,
race,
current
(varsayılan: race_day)
|
| track_style | string |
Pist stili
Değerler: relief, poster, clean, lino, riso, screenprint, contours, geometric, blueprint, ribbon, mosaic, halftone, negative, papercut, typographic, artdeco, stencil, pixel
(varsayılan: relief)
|
| track_source | string |
Harita kaynağı
Değerler: jules, commons
(varsayılan: jules)
|
| track_accent | string |
Renk vurguları
Değerler: 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
(varsayılan: all)
|
Yanıt
image/bmp
800×480
1bit / 4-bit B/W/R / 4-bit B/W/R/Y / Spectra 6
public, max-age=3600
BMP yanıtları ETag içerir. Görsel değişmediyse 304 almak için If-None-Match gönderin.
Kod Örnekleri
# 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=2026&round=6"
# 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();
}
E-Ink Ekran Kullanımı
/calendar.bmp dosyasını alın ve doğrudan E-Ink ekranınızda gösterin. Önerilen yenileme aralığı: 1-6 saatte bir. Herhangi bir 800×480 E-Ink ekranla uyumludur (ör. Waveshare 7.5", LaskaKit).
LaskaKit / zivyobraz.eu için:
- 1 zivyobraz.eu içinde içerik kaynağı olarak resim URL'si seçin
-
2
URL'yi yapıştırın:
https://f1.inkycloud.click/calendar.bmp?lang=cs&tz=Europe/Prague - 3 Yenileme aralığını 1-6 saat olarak ayarlayın
GET
/teams.bmp
1bit, B/W/R, B/W/R/Y veya Spectra 6 çıktı modlarında tüm F1 takımlarını, sürücülerini, fotoğraflarını ve şampiyona puanlarını gösteren bir BMP görseli oluşturun.
Görsel atıfları ve lisansları (pist çizimleri CC BY 4.0, Open-Meteo hava durumu CC BY 4.0): Credits sayfasına bakın. Yanıtlar ayrıca rel="license" içeren bir Link başlığı taşır.
Parametreler
| Parameter | Tür | Açıklama |
|---|---|---|
| lang | string |
Takvim metni için dil kodu
Değerler: cs, de, en, es, fr, it, ja, nl, pl, pt-BR, sk, tr, zh-CN (varsayılan:
en)
|
| year | integer |
Takım verileri için sezon yılı
opsiyonel — örn. 2026
|
| display | string |
Ekran çıktı modu
Değerler: 1bit,
bwr,
bwry,
spectra6 (varsayılan:
1bit)
|
| extra | string | İsteğe bağlı panel: none (varsayılan), countdown, flags, track, weather. Yerel sezon verilerini ve önbellekteki hava durumunu kullanır; kullanılamayan paneller gösterilmez. |
| 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. |
Yanıt
image/bmp
800×480
1-bit / 4-bit / Spectra 6
no-cache
Diğer endpoint'ler
/api/teams/{year}
Bir sezon için tüm takımları sürücüler ve puanlarla birlikte getir (JSON)
/api/standings/leader
Güncel şampiyona liderlerini getir (sürücü ve takım)
/api/standings/leader/{year}
/api/races/{year}
Belirli bir sezon için tüm yarışların listesi
/api/race/{year}/{round}
Takvim dahil ayrıntılı yarış bilgisi
/api/stats
Son 24 saatin istek istatistikleri
GET /api/stats/history
Saatlik istek geçmişi; limit: 1–720 (varsayılan 168).
GET / POST /api/perf-metrics
GET: performans özetleri; hours: 1–720 (varsayılan 24). POST: sayısal Web Vitals değerleri; ziyaretçi ve cihaz meta verileri yok sayılır.
GET /preview/{screen_type}.png
GET /preview/configure/{screen_type}.png
Takvim veya takımlar için PNG önizlemeleri; lang dili seçer. Yapılandırma önizlemeleri ayrıca display ve takvim için weather_type kabul eder (varsayılan off).
extra — İsteğe bağlı panel: none (varsayılan), countdown, flags, track, weather. Yerel sezon verilerini ve önbellekteki hava durumunu kullanır; kullanılamayan paneller gösterilmez.
track_style, track_source, track_accent — Pist stili, Harita kaynağı, Renk vurguları (calendar).
GET /health/ready
Veritabanı, yazılabilir depolama ve görsellerin güncelliği; hazır olduğunda HTTP 200, aksi durumda 503.
/health
Servis sağlık kontrolü
ADMIN_API_TOKEN yapılandırıldığında istatistik okuma API’leri X-Admin-Token veya Authorization: Bearer <token> gerektirir. MINIMAL_DATA_MODE=true olduğunda tüm istatistik API’leri 410 döndürür.
İstek sıklığı sınırını aşan istekler Retry-After ile 429 döndürür.