API

api.php liefert alle Kompaso-Werte für einen einzelnen Tag als JSON – zum Weiterverarbeiten in eigenen Skripten, Widgets oder anderen Apps.

Aufruf

GET api.php?date=YYYY-MM-DD

Ohne date wird der heutige Tag verwendet. Mit &pretty=0 kommt die Antwort kompakt (nicht eingerückt) zurück statt formatiert.

Beispiel

api.php?date=2026-09-19

{
    "date": "2026-09-19",
    "weekday": "6",
    "kompaso": {
        "year": 55,
        "monthName": "Maismanoth",
        "moonDays": 8,
        "sunDays": 272,
        "datum": "K-55-X-20",
        "sk": "X",
        "week": 39,
        "weekTotal": 52
    },
    "tzolkin": { "number": 24, "signature": "11 K'an" },
    "tonalpohualli": { "number": 114, "signature": "10 Ocēlōtl" },
    "cycleDay": 1002,
    "retrograde": { "count": 4, "planets": ["Saturn", "Uranus", "Neptun", "Pluto"] },
    "events": [ { "code": "apogee", "label": "Apogäum (Lilith)" } ]
}

Felder

• weekday – ISO-8601-Wochentag, 1 (Montag) bis 7 (Sonntag)
• kompaso.year – laufendes Jahr, wechselt an der Wintersonnenwende
• kompaso.monthName – Name des Mondmonats (z.B. "Maismanoth")
• kompaso.moonDays – Tage seit dem letzten Neumond
• kompaso.sunDays – Tage seit der letzten Wintersonnenwende
• kompaso.datum – klassisches KOMPASO-Datum, Format K-JJ-ZZ-TT (Jahr-Zyklus-Tag), inkl. Sonderfälle N-0 (Yul) und 0-0 (Tag der Unendlichkeit)
• kompaso.sk – nur die dritte Stelle (ZZ) des Kompaso-Datums, separat (z.B. "X", "N" am Yul-Tag, "0" am Tag der Unendlichkeit)
• kompaso.week / kompaso.weekTotal – laufende Woche seit Yul von insgesamt 52 Wochen im Jahr (13 Zyklen × 4 Wochen)
• tzolkin / tonalpohualli – laufende Nummer (1–260) plus Zahl/Zeichen-Signatur
• cycleDay – Tage seit dem letzten Start des 4-Jahreszyklus (Doppelnulljahr)
• retrograde – Anzahl und Namen der aktuell rückläufigen Planeten
• events – Liste besonderer Ereignisse an diesem Tag (Mondphasen, Sonnenwenden, Perigäum/Apogäum, Mondknoten, Sternschnuppen, Neujahr, Start des 4-Jahreszyklus), je mit code und label

Fehler

Ein ungültiges Datum (falsches Format oder nicht existierender Kalendertag, z.B. 2026-13-40) liefert HTTP 400 mit:

{ "error": "...", "given": "2026-13-40" }