Aller au contenu

Assistant pour la gestion des fuseaux horaires de l'horoscope

Utilisez cet assistant pour récupérer les identifiants IANA de fuseaux horaires acceptés avant d'appeler les routes de rapport de jours relatifs (today, yesterday, tomorrow).

Il permet d'éviter les erreurs liées au décalage horaire entre les régions et garantit que les utilisateurs dans différentes régions résolvent correctement le jour local.

Point de terminaison

Méthode Chemin
GET https://api.numerologyapi.com/api/v1/horoscope/timezones

Authentification

Fournissez votre en-tête de clé API :

  • X-API-Key: YOUR_API_KEY

Paramètres de la requête

Ce point de terminaison ne nécessite pas de paramètres de requête ou de corps.

Exemple de requête

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/timezones" \
  --header "X-API-Key: YOUR_API_KEY"

Exemple de réponse

{
  "count": 596,
  "timezones": [
    "Africa/Abidjan",
    "Africa/Accra",
    "Africa/Addis_Ababa"
  ]
}

Champs de réponse

Champ Type Description
count entier Nombre total d'identifiants de fuseaux horaires acceptés retournés.
timezones tableau de chaînes Noms de fuseaux horaires IANA pris en charge.

Flux d'intégration

  1. Appelez /api/v1/horoscope/timezones une fois et mettez en cache la liste dans votre backend/client.
  2. Validez le fuseau horaire sélectionné par l'utilisateur par rapport à cette liste.
  3. Envoyez le fuseau horaire validé dans les requêtes de rapport quotidien.

Exemple de requête quotidienne avec fuseau horaire :

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "TAURUS",
  "timezone": "America/New_York",
  "sections": ["general"]
}'

Notes

  • Utilisez le format IANA valide (par exemple : America/New_York, Africa/Douala, Asia/Tokyo).
  • Évitez les abréviations telles que EST, PST ou GMT+1.
  • count peut varier légèrement en fonction de l'environnement et de la version de tzdata.