منصة وطنية للبياناتعن المبادرة
الإصدار v1 · مستقر

بيانات مفتوحة,بسطر برمجي واحد.

واجهة REST موحّدة للوصول إلى آلاف مجموعات البيانات من مئات المنظمات، مع وثائق واضحة ومكتبات جاهزة وإشعارات فورية.

curl https://api.opendata.org/v1/datasets
وقت التشغيل
99.9%
زمن الاستجابة
<120ms
نقطة نهاية
40+
GET /v1/datasets/health-facilities200 OK
{
  "id": "health-facilities",
  "title": "Health facilities registry",
  "license": "CC-BY-4.0",
  "records": 4820,
  "resources": [
    { "format": "csv", "size": "1.2MB", "url": "…/health-facilities.csv" }
  ]
}

البدء السريع

من الصفر إلى أول استجابة في دقيقتين

  1. أنشئ حساباً واحصل على مفتاح

    سجّل مجاناً وأنشئ مفتاح API من مساحة عملك خلال ثوانٍ.

    إدارة المفاتيح
  2. أرسل طلبك الأول

    استخدم المفتاح في ترويسة Authorization واستعلم عن أي مجموعة بيانات.

    جرّب المستكشف
  3. ابن وانشر

    ادمج البيانات في تطبيقك وفعّل Webhooks لتبقى محدّثًا تلقائيًا.

    مكتبات جاهزة

مرجع الواجهات

مستكشف نقاط النهاية

اختر نقطة نهاية لعرض معاملاتها ومثال الطلب والاستجابة.

https://api.opendata.org/v1
GET/datasets

قائمة مجموعات البيانات

يعيد قائمة مقسمة إلى صفحات من مجموعات البيانات مع دعم التصفية حسب القطاع والصيغة والناشر.

المعاملات

qstring
نص البحث
sectorstring
معرّف القطاع
formatstring
csv | json | geojson
pageinteger
رقم الصفحة (الافتراضي 1)

جميع الطلبات عبر HTTPS. أرسل مفتاحك في ترويسة Authorization: Bearer ولا تضمّنه في كود الواجهة الأمامية.

cURL
curl -X GET "https://api.opendata.org/v1/datasets" \
  -H "Authorization: Bearer $API_KEY"
RESPONSE200
{
  "data": [
    {
      "id": "health-facilities",
      "title": "Health facilities registry",
      "publisher": "ministry-of-health",
      "formats": ["csv", "geojson"],
      "updated_at": "2026-07-12T09:30:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 1284 }
}

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

عادلة وشفافة

  • وصول عام

    دون مفتاح، للبيانات العامة فقط

    60

    طلب / ساعة

  • وصول بمفتاح API

    موصى به

    مفتاح مجاني، جميع نقاط النهاية

    5,000

    طلب / ساعة

  • وصول موسّع

    اتفاقية مستوى خدمة ودعم مخصص

    غير محدود

    بالاتفاقية

قيم توضيحية للعرض فقط، وقد تتغير الحدود النهائية.

أساسيات الاتصال

كل ما تحتاجه للاتصال

  • عنوان URL الأساسي

    https://api.opendata.org/v1
  • ترويسة Authorization

    Authorization: Bearer $API_KEY
  • صيغة الاستجابة (JSON)

    Content-Type: application/json

أسئلة شائعة