قيم مؤشر
معلومة مهمة. مؤشرات للمغرب برخصة CC BY 4.0. تقديرات دولية قابلة للمراجعة، وقد تختلف عن الإحصاءات الرسمية المغربية.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 18
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobjectالنتيجة المطلوبة: كائن واحد أو قائمة.
data.codestringرمز مؤشر البنك الدولي، مثل IT.NET.USER.ZS؛ احتفظ بالنقاط وحالة الأحرف.
data.namestringاسم المورد، وقد يكون موزّعاً حسب اللغة.
data.topic_codestringمعرّف موضوع البنك الدولي، يمكن استعماله لتصفية المؤشرات.
data.topicstringالاسم الكامل لموضوع البنك الدولي.
data.unitstring | nullوحدة المؤشر. إذا كانت null فراجع الاسم والتعريف؛ لا تفترض أنها نسبة مئوية.
data.periodicitystring | nullوتيرة نشر البيانات، مثل النشر السنوي.
data.licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"CC-BY-4.0"data.first_yearintegerأول سنة متاحة لهذا المؤشر.
data.last_yearintegerآخر سنة متاحة لهذا المؤشر.
data.value_countintegerعدد المشاهدات المتاحة لهذا المؤشر.
data.sourcestringالمنتج الأصلي للمؤشر حسب نسبة المصدر لدى البنك الدولي.
data.license_urlstringرابط شروط الرخصة؛ null عند غياب الرابط.
data.citation_notestring | nullبيان نسبة المصدر المطلوب عند إعادة استخدام المؤشر.
data.definitionstring | nullتعريف المؤشر؛ اقرأه مع الوحدة لفهم الأرقام.
data.valuesobject[]مشاهدات السنوات المطلوبة من الأقدم للأحدث. تُحذف السنوات بلا قيمة ولا تُعدّ صفراً.
data.values[].yearintegerالسنة التي تصفها البيانات، وليست سنة تنزيلها.
data.values[].valuenumberقيمة المؤشر للسنة المرتبطة، بوحدة المؤشر.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"name",
"topic_code",
"topic",
"unit",
"periodicity",
"license",
"first_year",
"last_year",
"value_count",
"source",
"license_url",
"citation_note",
"definition",
"values"
],
"properties": {
"code": {
"type": "string",
"description": "World Bank indicator code, e.g. IT.NET.USER.ZS."
},
"name": {
"type": "string"
},
"topic_code": {
"type": "string",
"description": "Identifier of the topic group, as listed by /api/v2/world-bank/indicators/topics."
},
"topic": {
"type": "string",
"description": "Full World Bank topic."
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
],
"description": "Unit of measure. Null when the World Bank metadata gives none; the unit is then only in the name."
},
"periodicity": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"license": {
"enum": [
"CC-BY-4.0"
]
},
"first_year": {
"type": "integer",
"minimum": 1960,
"maximum": 2100
},
"last_year": {
"type": "integer",
"minimum": 1960,
"maximum": 2100
},
"value_count": {
"type": "integer",
"minimum": 1
},
"source": {
"type": "string",
"description": "Original producer of the data, as credited by the World Bank."
},
"license_url": {
"type": "string",
"format": "uri"
},
"citation_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
],
"description": "Attribution requested by the World Bank for third-party use, when any."
},
"definition": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"values": {
"type": "array",
"description": "Values for the requested years, oldest first. Years without a value are omitted.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"year",
"value"
],
"properties": {
"year": {
"type": "integer",
"minimum": 1960,
"maximum": 2100
},
"value": {
"type": "number"
}
}
}
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"retrieved_at",
"transformation_version",
"sources"
],
"properties": {
"dataset": {
"enum": [
"world-bank-indicators"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"CC-BY-4.0"
]
},
"retrieved_at": {
"enum": [
"2026-10-15"
]
},
"transformation_version": {
"enum": [
"1.0.0"
]
},
"sources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"source_url",
"resource_url",
"license",
"source_updated_at"
],
"properties": {
"dataset": {
"type": "string"
},
"producer": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"resource_url": {
"type": "string",
"format": "uri"
},
"license": {
"enum": [
"CC-BY-4.0"
]
},
"source_updated_at": {
"type": "string",
"format": "date"
}
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 13
metaobjectسياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.
meta.datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"world-bank-indicators"meta.totalintegerعدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.
meta.licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"CC-BY-4.0"meta.retrieved_atstringتاريخ جلب المشروع لملف المصدر؛ وليس تاريخ رصد البيانات.
القيم المقبولة:
"2026-10-15"meta.transformation_versionstringإصدار قواعد تحويل مجموعة البيانات؛ مستقل عن إصدار الواجهة.
القيم المقبولة:
"1.0.0"meta.sourcesobject[]المصادر المستخدمة لهذه النتيجة مع الجهات المنتجة والرخص.
meta.sources[].datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
meta.sources[].producerstringالجهة التي تنشر البيانات الأصلية.
meta.sources[].source_urlstringصفحة نشر المصدر أو التعريف ببياناته.
meta.sources[].resource_urlstringرابط الملف أو المورد المستخدم فعلياً.
meta.sources[].licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"CC-BY-4.0"meta.sources[].source_updated_atstringآخر تحديث معلن من المصدر؛ وليس تاريخ جلب الملف.
الأخطاء
400: معامل غير صالح أو مفقود.404: المورد غير موجود.
تتضمن الأخطاء error.code وerror.message وerror.request_id.
errorobjectتفاصيل الطلب الفاشل؛ تحل محل data وmeta.
error.codestringرمز ثابت للخطأ، مثل RESOURCE_NOT_FOUND؛ استعمله في منطق التطبيق.
error.messagestringشرح مقروء للخطأ؛ استعمل code في منطق التطبيق.
error.request_idstringمعرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.