Playground lädt
curl -X POST https://api.occultapi.com/api/festivals/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"month":9,"keys":["festivals","ekadashis"]}'Vorberechnete Festtermine aus vier Traditionen, direkt aus einer Tabelle gelesen statt bei jeder Anfrage berechnet – ein ganzes Jahr kommt so mit einer einzigen indizierten Abfrage zurück. Mit `keys` wählst du die gewünschten Listen: `festivals` ist der zentrale Hindu-Kalender, `ekadashis` die vierundzwanzig oder sechsundzwanzig benannten Ekadashis des Jahres, und `jain_festivals`, `sikh_festivals` und `christian_festivals` sind die entsprechenden Kalender. `year` ist erforderlich, `month` (1-12) optional; ohne Monat erhältst du das ganze Jahr. Die Antwort ist `{data}` mit jeder angeforderten Kategorie als Schlüssel, jeweils mit einer chronologischen Liste von Ereignissen. Ein Ereignis enthält `name`, `name_hi` (eine Hindi-Fassung, derzeit nur in der zentralen Hindu-Kategorie befüllt und sonst null), `month` (der Name des Mondmonats), `paksha`, `tithi` (von der Sikh-Liste verwendet), `date` (verwendet, wenn der Festtag auf ein festes bürgerliches Datum fällt, wie bei den christlichen Festen) und `start_time`/`end_time`, die exakten Zeitpunkte, zu denen die maßgebliche Tithi beginnt und endet. Die Termine sind für die Jahre 2006 bis einschließlich 2046 vorberechnet. Für Jahre außerhalb dieses Bereichs kommen leere Listen zurück, kein Fehler. Da die Daten gespeichert sind und nicht pro Anfrage berechnet werden, nimmt dieser Endpoint keine Koordinaten entgegen. Brauchst du einen ortsabhängigen Festtag, nutze die Endpoints der Regionalkalender: Sie ordnen jedes Fest anhand des lokalen Sonnenauf- und -untergangs einem bürgerlichen Tag zu.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| keys | array | Pflicht | Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen. festivalsekadashisjain_festivalssikh_festivalschristian_festivalsWelche Festkalender geliefert werden. 'festivals' ist der zentrale Hindu-Kalender; die übrigen gehören zu anderen Traditionen. Fordere mehrere in einem Aufruf an – die Antwort ist nach Kategorien gegliedert, und die Kosten bleiben gleich. |
| year | integer | Pflicht | Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. Vierstellige Jahreszahl. Die Termine sind für 2006 bis 2046 vorberechnet; außerhalb dieses Bereichs ist die Antwort leer. |
| month | integer | optional | Geburtsmonat als Zahl, 1-12. Januar ist 1. Optional 1-12. Weglassen, um das ganze Jahr zu erhalten. min 1 · max 12 |