POST/api/astro/date_time/1 Credit

Zeitzonen-Ermittlung

Macht aus einer lokalen Geburtsuhrzeit und einem Koordinatenpaar einen eindeutigen Zeitpunkt. Alle anderen Endpoints hier erwarten entweder einen Zeitstempel mit Zeitzone oder einen numerischen UTC-Offset. Fehler an dieser Stelle sind die häufigste Ursache dafür, dass ein Horoskop unbemerkt um eine Stunde oder einen Tag danebenliegt – deshalb ist dies meist dein erster Aufruf. Sende `date`, `time`, `latitude` und `longitude`. Aus den Koordinaten wird eine IANA-Zeitzone ermittelt, Datum und Uhrzeit werden in dieser Zone interpretiert, und du erhältst `input_datetime`, den Namen der ermittelten Zeitzone `timezone`, `localized_datetime` mit Offset und `utc_datetime`. Den lokalisierten Wert kannst du bei anderen Endpoints direkt in `date_time` übergeben. Ein Vorbehalt: Das Anfragefeld heißt `use_LMT`, die View liest aber einen anders geschriebenen Namen. Die mittlere Ortszeit wird daher nie angewendet, es gilt immer die IANA-Zone – `use_lmt` ist in der Antwort immer false. Für Geburten aus der Zeit, bevor vor Ort eine Standardzeit eingeführt wurde, berechne den Offset der mittleren Ortszeit selbst (vier Minuten pro Längengrad), statt dich auf dieses Flag zu verlassen.

https://api.occultapi.com/api/astro/date_time/

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
date	string (date)	Pflicht	FORMATVORGABE, kein Enum. DRF DateField mit Standard-Eingabeformaten = nur ISO-8601: 'YYYY-MM-DD'.
latitude	number (double)	Pflicht	Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -180 · max 180
longitude	number (double)	Pflicht	Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. min -180 · max 180
time	string (time)	Pflicht	FORMATVORGABE, kein Enum. DRF TimeField mit Standard-Eingabeformaten = nur ISO-8601: 'HH:MM', 'HH:MM:SS' oder 'HH:MM:SS.ffffff'. Der Beispielwert "string" im Katalog ist irreführend.
use_LMT	boolean	optional

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/date_time/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1980-09-05","time":"04:42:05.037Z","longitude":80,"latitude":23,"use_LMT":true}'

Antwort

{
  "input_datetime": "1980-09-05 04:42:05",
  "latitude": 23,
  "longitude": 80,
  "timezone": "Asia/Kolkata",
  "use_lmt": false,
  "localized_datetime": "1980-09-05T04:42:05.037000+05:30",
  "utc_datetime": "1980-09-04T23:12:05.037000+00:00"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.