جنى القرآن

واجهة جنى القرآن البرمجية

مواقيت صلاة دقيقة لأي موقع في العالم عبر REST API. مجانية للجميع، ويُنشأ المفتاح من لوحة التحكم.

المصادقة

يُرسل المفتاح في الترويسة x-api-key، ولا يُقبل داخل الرابط لأن الروابط تُحفظ في السجلات.

GET /api/v1/prayer-times

lat, lngإلزاميالإحداثيات
tzاختياريالمنطقة الزمنية IANA (الافتراضي UTC)
methodاختياريKuwait, UmmAlQura, Egyptian, MuslimWorldLeague, Karachi, Dubai, Qatar, NorthAmerica, MoonsightingCommittee, Singapore, Turkey, Tehran
madhabاختياريshafi | hanafi
highLatitudeRuleاختياريtwilightAngle | seventhOfTheNight | middleOfTheNight (الافتراضي twilightAngle)
dateاختياريYYYY-MM-DD (الافتراضي اليوم)
monthاختياريYYYY-MM لجدول شهر كامل
curl -H "x-api-key: sk_live_..." \
  "https://janaquran.vercel.app/api/v1/prayer-times?lat=29.3759&lng=47.9774&tz=Asia/Kuwait&method=Kuwait"
{
  "location": { "latitude": 29.3759, "longitude": 47.9774, "timezone": "Asia/Kuwait" },
  "method": "Kuwait",
  "madhab": "shafi",
  "highLatitudeRule": "twilightAngle",
  "date": "2026-11-04",
  "hijri": { "day": 24, "month": 5, "year": 1448, "monthName": "جُمَادَى الأُولَى", ... },
  "times": { "fajr": "2026-11-04T01:42:00.000Z", ... },
  "local": { "fajr": "04:42", "sunrise": "06:03", "dhuhr": "11:32", ... }
}

خطوط العرض العليا: الأساس قاعدة زاوية الشفق (twilightAngle)، كما في AlAdhan. لا تغيّر وقتًا بين خطّي عرض 44 شمالًا و44 جنوبًا تقريبًا، وتضبط الفجر والعشاء فيما وراءهما في ليالي الصيف التي لا يغيب فيها الشفق. كانت القاعدة قبلها منتصف الليل، فقد يختلف الفجر والعشاء هناك في الصيف حتى ساعتين عن إجابات سابقة. ولاختيار قاعدة أخرى يُرسل highLatitudeRule.

ترويسات الاستجابة: X-RateLimit-Limit و X-RateLimit-Remaining. عند تجاوز الحد اليومي: 429.

GET /api/public/mosques/:slug

بيانات مسجد عامة (بدون مفتاح): المواقيت، الإقامة، الجمعة، والإعلانات.

curl "https://janaquran.vercel.app/api/public/mosques/demo"

واجهات التطبيق (للجوال)

POST /api/auth/register   { name, email, password }  → { token, user }
POST /api/auth/login      { email, password }        → { token, user }
POST /api/auth/delete-account { password }           → { ok }
GET  /api/me              Authorization: Bearer <token>
GET  /api/me/sync         → { data, updatedAt }
PUT  /api/me/sync         { data }  → { ok, updatedAt }
GET  /api/public/announcements