KWnummer.de

KW-API für Entwickler

Kostenloses, offenes und cachefreundliches JSON-API für die aktuelle Kalenderwoche nach ISO 8601. Kein API-Key nötig, CORS ist offen, Antworten werden fünf Minuten gecacht.

GET /api/week.json

{
  "current_week": 28,
  "year": 2026,
  "iso_start": "2026-07-06",
  "iso_end": "2026-07-12",
  "today": "2026-07-06",
  "updated_at": "2026-07-06T06:00:00.000Z"
}

Beispiel (JavaScript)

fetch('https://kwnummer.de/api/week.json')
  .then(r => r.json())
  .then(data => console.log('Es ist KW ' + data.current_week));

GET /api/month.json

Kalendergrid des aktuellen Monats: Wochenzeilen mit Datum, aktuelle KW, heutiges Datum und die bundesweiten Feiertage (red_days, regionale separat in regional_holidays). Eine Stunde gecacht — die Datenquelle hinter unserem Kalender-Widget.

GET /api/health.json

Leichter Statuscheck — antwortet mit { "status": "ok", ... }.

Embed-Skript

Ohne eigenen Code: Der Widget-Generator liefert fertige Einbettungen — KW-Karte, Badge oder Monatskalender, mit Theme und Akzentfarbe, gerendert im Shadow DOM.

Bedingungen

  • Freie Nutzung, auch kommerziell. Nennen Sie gern kwnummer.de als Quelle.
  • Cachen Sie Antworten mindestens 5 Minuten — die KW ändert sich nur einmal pro Woche.