الكسوف والخسوف

الكسوف والخسوف من ٢٠٢٠ إلى ٢٠٤٠ — الأنواع وأوقات الذروة والمقادير ومدد الخسوف ونقاط الذروة الأرضية، من المحرك المتحقق منه نفسه الذي يرسم خرائط الكسوف.

GET https://theshia.org/api/v1/eclipses

المعاملات

kind optional values: "solar" · "lunar".
type optional values: "total" · "annular" · "hybrid" · "partial" · "penumbral".
from optional start of the window — YYYY or YYYY-MM-DD (dataset covers 2020 to 2040).
to optional end of the window — YYYY (through that year's end) or YYYY-MM-DD.
upcoming optional 1 to 24 — the next N eclipses from today, each with daysUntil. Not combinable with from/to.
calendar default: moonsighting reckoning for the returned Hijri dates — values: "moonsighting" · "iran".

Response per eclipse: kind, type, utc (maximum, ISO 8601), gamma, magnitude (partial-solar / umbral-lunar; null otherwise), penumbralMag + durationsMin { penumbral, partial, total } for lunar, greatest { lat, lon, central } for solar, and hijri { hy, hm, hd }.
Computed by this site's fresh Meeus ch. 49/54 engine, verified against the NASA GSFC catalog (times of maximum within ~1 minute; penumbral grazes under magnitude ~0.005 fall below the method's noise floor).
Penumbral lunar eclipses are generally imperceptible and commonly not counted for Salat al-Ayat.

افتح مثالاً حياً ↗

أمثلة برمجية

curl

curl "https://theshia.org/api/v1/eclipses?upcoming=4"

JavaScript

const res = await fetch("https://theshia.org/api/v1/eclipses?upcoming=4");
const data = await res.json();

Python

import requests

data = requests.get("https://theshia.org/api/v1/eclipses?upcoming=4").json()

حدود الاستخدام

الاستجابات مخزنة بقوة على الحافة — يرجى التخزين من جهتكم أيضاً. الطلبات غير المخزنة محدودة بـ١٠٠ في الدقيقة لكل IP؛ والطلبات الضخمة (أكثر من ٤٩٦ حسابَ يوم×طريقة) تُرفض. مجاني للاستخدام المجتمعي، بلا ضمان توافر.