Asisten Zona Waktu Horoskop¶

Gunakan asisten ini untuk mengambil ID zona waktu IANA yang diterima sebelum memanggil rute laporan hari relatif (today, yesterday, tomorrow).

Ini mencegah kesalahan perubahan tanggal antar wilayah dan memastikan pengguna di berbagai geografis menyelesaikan hari lokal yang benar.

Titik Akhir (Endpoint)¶

Otorisasi¶

Berikan header kunci API Anda:

• X-API-Key: YOUR_API_KEY

Parameter Permintaan¶

Titik akhir ini tidak memerlukan parameter kueri atau badan.

Contoh Permintaan¶

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

Contoh Respons¶

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

Bidang Respons¶

Alur Integrasi¶

1. Panggil /api/v1/horoscope/timezones sekali dan simpan daftar di backend/klien Anda.
2. Validasi zona waktu yang dipilih pengguna terhadap daftar tersebut.
3. Kirim zona waktu yang divalidasi dalam permintaan laporan harian.

Contoh permintaan harian dengan zona waktu:

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

Catatan- Gunakan format IANA yang valid (misalnya: America/New_York, Africa/Douala, Asia/Tokyo).¶

• Hindari singkatan seperti EST, PST, atau GMT+1.
• Nilai count dapat sedikit berbeda tergantung pada lingkungan dan versi tzdata.