Przejdź do treści

Pomocnik dla stref czasowych Horoskopu

Użyj tego pomocnika, aby pobrać akceptowane identyfikatory stref czasowych IANA przed wywoływaniem tras raportów dotyczących dni (today, yesterday, tomorrow).

Zapobiega to błędom wynikającym z różnic w datach między regionami i zapewnia, że użytkownicy w różnych lokalizacjach prawidłowo interpretują lokalny dzień.

Endpoint

Metoda Ścieżka
GET https://api.numerologyapi.com/api/v1/horoscope/timezones

Autentykacja

Podaj nagłówek z kluczem API:

  • X-API-Key: YOUR_API_KEY

Parametry żądania

Ten endpoint nie wymaga parametrów zapytania ani ciała.

Przykład żądania

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

Przykład odpowiedzi

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

Pola odpowiedzi

Pole Typ Opis
count integer Liczba akceptowanych identyfikatorów stref czasowych zwróconych.
timezones array[string] Obsługiwane nazwy stref czasowych IANA.

Przepływ integracji

  1. Wywołaj /api/v1/horoscope/timezones raz i zapisz listę w swoim backendzie/kliencie.
  2. Zweryfikuj wybraną przez użytkownika strefę czasową względem tej listy.
  3. Prześlij zweryfikowaną strefę czasową w żądaniach dotyczących raportów dziennych.

Przykład żądania dziennego z informacją o strefie czasowej:

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

Uwagi- Używaj poprawnego formatu IANA (np. America/New_York, Africa/Douala, Asia/Tokyo).

  • Unikaj skrótów takich jak EST, PST lub GMT+1.
  • Wartość count może się nieznacznie różnić w zależności od środowiska i wersji tzdata.