للمطورين
نقطة واحدة تجيب: ما التاريخ الهجري اليوم؟
واجهة JSON مجانية، بلا مفتاح، وCORS مفتوح لطلبات GET. العنوان الأساسي https://globalhilal.com/api/v1.
٥ شهرًا منشورًا — والعدّ بالشهادة، لا بالتوقع.
GET /today
تاريخ اليوم الهجري. المعاملان tz (IANA، الافتراضي UTC) وdate (YYYY-MM-DD، للاختبار).
curl "https://globalhilal.com/api/v1/today?tz=Asia/Jakarta"
GET /convert
التاريخ الهجري لأي تاريخ ميلادي: ?gregorian=YYYY-MM-DD&tz=…
curl "https://globalhilal.com/api/v1/convert?gregorian=2026-03-20"
GET /months
السجل، الأحدث أولًا. المعاملات hijri_year وstatus وperPage وpage.
curl "https://globalhilal.com/api/v1/months?hijri_year=1447"
GET /months/current · /months/:year/:month
الشهر الجاري، أو التفاصيل الكاملة مع الشهادات والمصادر.
curl "https://globalhilal.com/api/v1/months/1447/9"
تأتي الأخطاء بالشكل { error: { code, message } } — INVALID_TZ، INVALID_DATE، NOT_FOUND، OUT_OF_RANGE.
التواريخ التي تتجاوز الشهادة المؤكدة تُعيد OUT_OF_RANGE: فالواجهة لا تخمّن المستقبل. والتغييرات الجذرية تُصدر باسم /v2، ويبقى /v1 متاحًا 12 شهرًا على الأقل.