🔌 API مواقيت الصلاة للمطورين

الرابط الأساسي (Base URL)

https://times.afkaark.com/api/v1/

1. قائمة كل المدن

GET /api/v1/cities.json

تُعيد قائمة بجميع المدن المتاحة مع معرّفها ودولتها وإحداثياتها ورابط بيانات مواقيتها، لتستخدمها في بناء قائمة اختيار المدينة داخل تطبيقك.

2. مواقيت الصلاة لمدينة محددة

GET /api/v1/times/{country}/{city_id}.json

مثال: /api/v1/times/egypt/cairo.json

تُعيد مواقيت الصلاة الخمسة زائد الشروق لليوم الحالي، مع اتجاه القبلة والمسافة إلى الكعبة، وطريقة الحساب المعتمدة للمدينة. مثال على الاستجابة:

{
  "city": {"id": "cairo", "name_ar": "القاهرة", "country": "egypt"},
  "date": "2026-08-29",
  "method": "الهيئة المصرية العامة للمساحة",
  "times": {"fajr": "04:12", "sunrise": "05:41", "dhuhr": "12:03", "asr": "15:29", "maghrib": "18:24", "isha": "19:47"},
  "qibla": {"angle": 136.02, "distance_km": 1240.5},
  "source": "https://times.afkaark.com/egypt/cairo/"
}

أمثلة استخدام سريعة

JavaScript (fetch):

fetch("https://times.afkaark.com/api/v1/times/egypt/cairo.json")
  .then(r => r.json())
  .then(data => console.log(data.times));

Python:

import requests
r = requests.get("https://times.afkaark.com/api/v1/times/egypt/cairo.json")
print(r.json()["times"])

cURL:

curl https://times.afkaark.com/api/v1/times/egypt/cairo.json

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

روابط ذات صلة