Assistente per il fuso orario dell'oroscopo¶

Utilizza questo assistente per recuperare gli ID dei fusi orari IANA accettati prima di chiamare le rotte relative al report (today, yesterday, tomorrow).

Questo previene errori dovuti allo sfasamento delle date tra regioni e garantisce che gli utenti in diverse aree geografiche risolvano il giorno locale corretto.

Endpoint¶

Metodo	Percorso
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

Autenticazione¶

Fornisci l'header con la chiave API:

X-API-Key: YOUR_API_KEY

Parametri della richiesta¶

Questo endpoint non richiede parametri di query o del corpo.

Esempio di richiesta¶

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

Esempio di risposta¶

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

Campi della risposta¶

Campo	Tipo	Descrizione
`count`	integer	Numero totale di ID dei fusi orari accettati restituiti.
`timezones`	array[string]	Nomi dei fusi orari IANA supportati.

Flusso di integrazione¶

Chiama /api/v1/horoscope/timezones una volta e memorizza l'elenco nel tuo backend/client.
Verifica il fuso orario selezionato dall'utente rispetto a quell'elenco.
Invia il fuso orario verificato nelle richieste di report giornaliero.

Esempio di richiesta giornaliera con fuso orario:

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

Note¶

Utilizzare il formato IANA valido (ad esempio: America/New_York, Africa/Douala, Asia/Tokyo).
Evitare abbreviazioni come EST, PST o GMT+1.
count può variare leggermente a seconda dell'ambiente e della versione di tzdata.