مساعد تحديد المنطقة الزمنية للتوقعات الفلكية¶

استخدم هذا المساعد للحصول على معرفات مناطق زمن IANA المقبولة قبل استدعاء مسارات تقرير اليوم النسبي (today, yesterday, tomorrow).

فهو يمنع أخطاء تغيير التاريخ عبر المناطق ويضمن أن المستخدمين في مناطق جغرافية مختلفة يحلون اليوم المحلي الصحيح.

نقطة النهاية (Endpoint)¶

الطريقة	المسار
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

المصادقة (Auth)¶

قم بتوفير رأس مفتاح واجهة برمجة التطبيقات الخاص بك:

X-API-Key: YOUR_API_KEY

معلمات الطلب¶

لا يتطلب هذا المسار معلمات استعلام أو جسم.

مثال على الطلب¶

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

مثال على الاستجابة¶

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

حقول الاستجابة¶

الحقل	النوع	الوصف
`count`	عدد صحيح	العدد الإجمالي لمعرفات مناطق زمن IANA المقبولة التي تم إرجاعها.
`timezones`	مصفوفة من السلاسل	أسماء مناطق زمن IANA المدعومة.

سير عمل التكامل¶

استدعِ /api/v1/horoscope/timezones مرة واحدة وقم بتخزين القائمة في الواجهة الخلفية/العميل الخاص بك.
تحقق من المنطقة الزمنية التي اختارها المستخدم مقابل تلك القائمة.
أرسل المنطقة الزمنية المعتمدة في طلبات تقرير اليوم.

مثال على طلب يومي مع المنطقة الزمنية:

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

ملاحظات¶

استخدم تنسيق IANA الصحيح (على سبيل المثال: America/New_York، Africa/Douala، Asia/Tokyo).
تجنب الاختصارات مثل EST، PST أو GMT+1.
قد يختلف count قليلاً حسب البيئة وإصدار tzdata.