مركز الـ API
كل بياناتنا متاحةٌ عبر واجهة REST واحدة تحت /api/v1، بمظروف استجابة قياسي { ok, data, error, meta }. البيانات مرخّصة بـ CC BY 4.0، وحدّ المعدّل 240 طلبًا في الدقيقة لكل عنوان IP.
?page=1&limit=50
الترميز: UTF-8 · JSON
الطريقة: GET فقط (قراءة)
الترخيص: CC BY 4.0
/api/v1/stats
بلا مُعاملات
إحصاءات المنصة — عدّادات شاملة لكل المراصد (مشاريع، مناطق حرة، مهارات، تراث، مجموعات بيانات) مع المؤشرات الاقتصادية الكلية الموسومة بالمصدر والسنة.
/api/v1/search
2 مُعامل
البحث الشامل — بحثٌ موحّد عبر جميع المراصد دفعةً واحدة — يُرجِع نتائج مصنّفة بالنوع مع روابط مباشرة لكل سجل.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| q | string | نص البحث (مطلوب لإرجاع نتائج). | ذكاء |
| limit | integer | حدّ النتائج لكل نوع. الافتراضي 8. | 8 |
/api/v1/projects
7 مُعامل
قائمة المشاريع — قائمة مشاريع الابتكار قابلة للبحث والتصفية والترتيب والترقيم. تتضمن بيانات الترقيم في كتلة meta.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| q | string | بحث في الاسم والمهمة والمشكلة والمكدّس التقني. | استدامة |
| sector | string | تصفية حسب مفتاح القطاع (sector_key): mobility · environment · health · energy · education · finance · … | mobility |
| emirate | string | تصفية حسب الإمارة. | Dubai |
| minImpact | integer | حدّ أدنى لدرجة الأثر (0–10). | 7 |
| sort | string | الترتيب: impact · innovation · sustainability · emiratization · golden_visa · avg · name | impact |
| page | integer | رقم الصفحة. الافتراضي 1. | 1 |
| limit | integer | عدد العناصر لكل صفحة (1–200). الافتراضي 24. | 24 |
/api/v1/projects/facets
بلا مُعاملات
وجوه تصنيف المشاريع — تجميعات جاهزة للفلاتر: عدد المشاريع ومتوسط الأثر لكل قطاع، وتوزيعها على الإمارات.
/api/v1/projects/:id
1 مُعامل
تفاصيل مشروع — سجل مشروع كامل بكل درجاته وفرص الذكاء الاصطناعي والبيانات والمصادر المفتوحة. يُرجِع 404 إذا لم يوجد.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| id | path | معرّف المشروع. | p001 |
/api/v1/free-zones
7 مُعامل
قائمة المناطق الحرة — المناطق الحرة عبر الإمارات السبع مع نطاقات التكلفة والقطاعات وعدد التأشيرات والثقة — قابلة للبحث والتصفية والترقيم.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| q | string | بحث في الاسم والمميزات (عربي/إنجليزي). | تقنية |
| emirate | string | تصفية حسب الإمارة. | Dubai |
| costBand | string | نطاق التكلفة: low · mid · high | mid |
| sector | string | تصفية حسب قطاع مدعوم. | media |
| sort | string | الترتيب: cost_asc · cost_desc · established · visas · confidence · name | cost_asc |
| page | integer | رقم الصفحة. الافتراضي 1. | 1 |
| limit | integer | عدد العناصر لكل صفحة (1–200). الافتراضي 36. | 36 |
/api/v1/free-zones/facets
بلا مُعاملات
وجوه تصنيف المناطق الحرة — تجميعات الفلاتر: عدد ومتوسط التكلفة لكل إمارة، وتوزيع نطاقات التكلفة، وعدد المناطق لكل قطاع.
/api/v1/free-zones/:id
1 مُعامل
تفاصيل منطقة حرة — سجل منطقة حرة كامل بقطاعاتها وتكاليفها ومميزاتها ودرجة الثقة. يُرجِع 404 إذا لم يوجد.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| id | path | معرّف المنطقة الحرة. | fz01 |
/api/v1/skills
3 مُعامل
مهارات الذكاء الاصطناعي — كتالوج مهارات الذكاء الاصطناعي بالمستويات والأمثلة التطبيقية، مع وجوه التصنيف في كتلة meta.facets.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| category | string | تصفية حسب فئة المهارة: Foundation · Data · Technical · Business · Governance · Cybersecurity | Technical |
| level | string | المستوى: Beginner · Intermediate · Advanced | Advanced |
| q | string | بحث في اسم المهارة ومثال الاستخدام. | تحليل |
/api/v1/observatory
بلا مُعاملات
مرصد التبنّي — لقطة مرصد تبنّي الذكاء الاصطناعي: مؤشرات الأداء، التبنّي حسب الوظيفة، الطلب على المهارات، والمؤشرات الزمنية مع خطوط الأساس والأهداف.
/api/v1/culture
2 مُعامل
عناصر التراث — عناصر تراثية بإحداثيات على الخريطة وموسومة بالمحور والوسوم والمصدر ودرجة الثقة — قابلة للتصفية بالمحور والبحث.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| theme | string | تصفية حسب المحور الثقافي: turuq · mawasem · hikayat · thaqafah · lahja · maktabati | turuq |
| q | string | بحث في العنوان والملخص. | صقور |
/api/v1/culture/themes
بلا مُعاملات
المحاور الثقافية — قائمة المحاور الثقافية مع عدد العناصر في كل محور — مثالية لبناء فلاتر شريط الرقائق.
/api/v1/datasets
2 مُعامل
كتالوج مجموعات البيانات — فهرس مجموعات البيانات القابلة للتصدير، بعدد السجلات والصيغة والمصدر والترخيص ووصف الحقول — قابل للتصفية بالتصنيف والبحث.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| category | string | تصفية حسب التصنيف. | AI |
| q | string | بحث في العنوان والوصف (عربي/إنجليزي). | سياحة |
/api/v1/datasets/:id
1 مُعامل
تفاصيل مجموعة بيانات — بطاقة مجموعة بيانات كاملة بحقولها ونقطة الوصول والترخيص. يُرجِع 404 إذا لم توجد.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| id | path | معرّف مجموعة البيانات. | ds01 |
/api/v1/categories
بلا مُعاملات
تصنيفات البيانات — عدد مجموعات البيانات لكل تصنيف — مرتّبة تنازليًا حسب العدد.
/api/v1/graph
1 مُعامل
الرسم المعرفي — عقد وحواف الرسم المعرفي الذي يربط الإمارات والقطاعات والمناطق الحرة والمشاريع وفئات المهارات. يمكن تصفيته بأنواع العقد.
| المُعامل | النوع | الوصف | مثال |
|---|---|---|---|
| types | string | أنواع العقد مفصولةً بفواصل: emirate · sector · freezone · fzsector · project · skillcat | emirate,sector |