Ajutor pentru identificarea fusului orar al horoscopului¶

Utilizați acest ajutor pentru a obține ID-urile IANA ale fusurilor orare acceptate înainte de a apela rutele relative-day report (today, yesterday, tomorrow).

Acesta previne erorile cauzate de schimbarea datei în diferite regiuni și asigură că utilizatorii din diferite locații interpretează corect ziua locală.

Endpoint¶

Metodă	Cale
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

Autentificare¶

Furnizați header-ul cu cheia API:

X-API-Key: YOUR_API_KEY

Parametrii cererii¶

Acest endpoint nu necesită parametri de interogare sau corp.

Exemplu de cerere¶

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

Exemplu de răspuns¶

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

Câmpuri de răspuns¶

Câmp	Tip	Descriere
`count`	integer	Numărul total de ID-uri IANA ale fusurilor orare returnate.
`timezones`	array[string]	Numele IANA ale fusurilor orare suportate.

Fluxul de integrare¶

Apelați /api/v1/horoscope/timezones o singură dată și stocați lista în backend-ul/client.
Verificați fusul orar selectat de utilizator împotriva acelei liste.
Trimiteți fusul orar validat în cererile zilnice de raportare.

Exemplu de cerere zilnică cu fus orar:

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¶

Utilizați formatul IANA valid (de exemplu: America/New_York, Africa/Douala, Asia/Tokyo).
Evitați abrevierile precum EST, PST sau GMT+1.
count poate varia ușor în funcție de mediul și versiunea tzdata.