POST/api/astro/date_time/1 crédit

Résolution du fuseau horaire

À partir d’une heure de naissance en heure locale et d’une paire de coordonnées, détermine un instant sans ambiguïté. Tous les autres endpoints attendent soit un horodatage avec fuseau, soit un décalage UTC numérique, et une erreur à ce niveau est la cause la plus fréquente d’un thème décalé d’une heure ou d’un jour sans que rien ne le signale : c’est donc en général le premier appel à faire. Envoyez `date`, `time`, `latitude` et `longitude`. Les coordonnées sont converties en fuseau horaire IANA, la date et l’heure naïves sont interprétées dans ce fuseau, et vous recevez `input_datetime`, le nom du fuseau trouvé `timezone`, `localized_datetime` avec son décalage, et `utc_datetime`. La valeur localisée peut être passée telle quelle dans `date_time` sur les autres endpoints. Une réserve : le champ de la requête s’écrit `use_LMT`, mais la vue lit un nom orthographié autrement. Le temps moyen local n’est donc jamais appliqué et le fuseau IANA est toujours utilisé — `use_lmt` vaut toujours false dans la réponse. Pour une naissance antérieure à l’adoption locale de l’heure légale, calculez vous-même le décalage du temps moyen local (quatre minutes par degré de longitude) au lieu de compter sur cet indicateur.

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

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

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

Champs de la requête

Champ	Type	Obligatoire	Remarques
date	string (date)	obligatoire	Contrainte de FORMAT, pas une énumération. DateField DRF avec les formats d’entrée par défaut = ISO-8601 uniquement : 'YYYY-MM-DD'.
latitude	number (double)	obligatoire	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -180 · max 180
longitude	number (double)	obligatoire	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180
time	string (time)	obligatoire	Contrainte de FORMAT, pas une énumération. TimeField DRF avec les formats d’entrée par défaut = ISO-8601 uniquement : 'HH:MM', 'HH:MM:SS' ou 'HH:MM:SS.ffffff'. La valeur d’exemple du catalogue "string" est trompeuse.
use_LMT	boolean	facultatif

Exemple de requête

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}'

Réponse

{
  "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"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.