الواجهة البرمجية (API)

الإصدار v1 — قراءة فقط

شروط الاستخدام

الإسناد إلزامي: كل عرض لبيانات المنصة يذكر المصدر ويربط لصفحة الشهيد (حقل page_url في كل استجابة).
لا تخزين دائم: اعرض البيانات مباشرة أو بكاش مؤقت قصير — عند إزالة محتوى بطلب عائلته يجب أن يختفي من تطبيقك أيضاً (السجل المحذوف يرجع 404).
الواجهة للقراءة فقط ولا تُخرج أي بيانات شخصية، وحد الاستهلاك 60 طلباً بالدقيقة.

نقاط النهاية

المسار	الوصف
GET /api/v1/martyrs	قائمة الشهداء المنشورين (ترقيم صفحات؛ مرشحات: governorate، year، per_page)
GET /api/v1/martyrs/{slug}	صفحة شهيد كاملة مع السيرة السردية والمصادر
GET /api/v1/incidents	الوقائع والمعارك
GET /api/v1/incidents/{slug}	واقعة واحدة
GET /api/v1/resistance-stories	قصص النصر والمقاومة
GET /api/v1/resistance-stories/{slug}	قصة واحدة
GET /api/v1/map.geojson	كل نقاط الخريطة بصيغة GeoJSON

مثال

GET https://shaheed.haydary.com/api/v1/martyrs/abu-tahsin-al-salhi

{
  "data": {
    "slug": "abu-tahsin-al-salhi",
    "name": "أبو تحسين الصالحي",
    "nickname": "شيخ القناصين",
    "force": "الحشد الشعبي",
    "martyrdom_date": "2017-09-29",
    "summary": "…",
    "story": "…",
    "sources": [ { "title": "…", "url": "…" } ],
    "page_url": "https://shaheed.haydary.com/martyrs/abu-tahsin-al-salhi",
    "attribution": "منصة توثيق شهداء العراق — يُشترط الإسناد والربط لصفحة الشهيد عند إعادة النشر"
  }
}

للربط الرسمي

الجهات والتطبيقات الراغبة بربط رسمي (مفاتيح مخصصة، حدود أعلى، دعم) تتواصل مع فريق المنصة عبر استمارة أي صفحة شهيد مع ذكر «طلب ربط برمجي».