MoroccoAPIبيانات مستشفى
معلومة مهمة. الرعاية الأولية: سجل 2024 مع تأكيدات جزئية في 2026. البنية الخاصة: أرقام 2024؛ لا تجمع الإجمالي الوطني مع الأرقام الجهوية.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 15
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobjectالنتيجة المطلوبة: كائن واحد أو قائمة.
data.idstringمعرّف هذا العنصر في مجموعة البيانات؛ ليس بالضرورة رمزاً رسمياً.
data.namestringاسم المورد، وقد يكون موزّعاً حسب اللغة.
data.aliasesstring[]أسماء أخرى للمورد نفسه تساعد في التعرّف عليه أو البحث عنه.
data.categorystring | nullفئة المؤسسة أو بادئة الهاتف؛ استعمل القيم المنشورة.
data.category_labelstring | nullالاسم المقروء لفئة المؤسسة.
data.ownershipstring | nullكون المؤسسة عمومية أو خاصة، حسب السجل.
data.region_codestringمعرّف الجهة؛ null للسطر الذي يمثل المغرب كله.
data.province_codestringمعرّف الإقليم أو العمالة الأم، تحت الجهة.
data.commune_codestring | nullمعرّف الجماعة الأم: وحدة محلية حضرية أو قروية، وليست بالضرورة مدينة.
data.arrondissement_codestring | nullمعرّف مقاطعة، وهي تقسيم حضري داخل جماعة.
data.reference_yearinteger | nullالسنة التي تصفها الأرقام أو السجل، وهي مستقلة عن تاريخ النشر والجلب.
data.locationnull | objectإحداثيات الموقع الواردة في المصدر، عند توفرها.
data.location.latitudenumberخط العرض وفق WGS 84 بالدرجات العشرية: موجب شمالاً وسالب جنوباً.
data.location.longitudenumberخط الطول وفق WGS 84 بالدرجات العشرية: موجب شرقاً وسالب غرباً.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"name",
"aliases",
"category",
"category_label",
"ownership",
"region_code",
"province_code",
"commune_code",
"arrondissement_code",
"reference_year",
"location"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"aliases": {
"type": "array",
"items": {
"type": "string"
}
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"category_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"ownership": {
"anyOf": [
{
"enum": [
"public"
]
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"region_code": {
"type": "string"
},
"province_code": {
"type": "string"
},
"commune_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"arrondissement_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"reference_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"location": {
"anyOf": [
{
"type": "string",
"nullable": true,
"enum": [
null
]
},
{
"type": "object",
"additionalProperties": false,
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
}
}
}
]
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"retrieved_at",
"transformation_version",
"sources"
],
"properties": {
"dataset": {
"enum": [
"hospitals"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"retrieved_at": {
"enum": [
"2026-10-06"
]
},
"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": [
"ODbL-1.0",
"CC-BY-4.0"
]
},
"source_updated_at": {
"type": "string",
"format": "date"
}
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 13
metaobjectسياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.
meta.datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"hospitals"meta.totalintegerعدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.
meta.licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"ODbL-1.0"meta.retrieved_atstringتاريخ جلب المشروع لملف المصدر؛ وليس تاريخ رصد البيانات.
القيم المقبولة:
"2026-10-06"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 وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"ODbL-1.0""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معرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.