أصناف المؤسسات
معلومة مهمة. ملفات أرسلها بنك المغرب في 4 نونبر 2026: قائمتان منفصلتان للمؤسسات والرموز البنكية دون مطابقة تلقائية. يشترط الميثاق ذكر المصدر وتاريخ النسخ؛ والاستعمال التجاري يتطلب إذناً كتابياً. تُحفظ البيانات الأصلية بالفرنسية.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
meta.pagination: القوائم: 100 نتيجة افتراضياً، و500 كحد أقصى. استخدم limit وoffset؛ تكون meta.pagination.next_offset بقيمة null في الصفحة الأخيرة.
مثال توضيحي: مع limit=10 وoffset=0 تتضمن الصفحة الأولى 10 نتائج على الأكثر. إذا كانت next_offset تساوي 10، اطلب التالية بـoffset=10 والمرشحات نفسها. توقف عندما تصبح next_offset بقيمة null.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 5
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobject[]النتيجة المطلوبة: كائن واحد أو قائمة.
data[].datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"institutions""bank-codes"data[].codestringرمز الصنف الخاص بالمرجع المحدد في dataset.
data[].namestringالاسم الفرنسي محفوظ كما ورد في ملف بنك المغرب.
data[].countintegerعدد السجلات في هذا الصنف من الملف الأصلي.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"code",
"name",
"count"
],
"properties": {
"dataset": {
"type": "string",
"enum": [
"institutions",
"bank-codes"
]
},
"code": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"count": {
"type": "integer",
"minimum": 1
}
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"total",
"received_at",
"copied_at",
"transformation_version",
"license",
"terms_url",
"terms_section",
"attribution",
"notice",
"reuse",
"limitations",
"sources",
"pagination"
],
"properties": {
"dataset": {
"enum": [
"bam-banking"
]
},
"producer": {
"enum": [
"Bank Al-Maghrib"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"received_at": {
"type": "string",
"format": "date"
},
"copied_at": {
"type": "string",
"format": "date"
},
"transformation_version": {
"type": "string",
"minLength": 1
},
"license": {
"enum": [
"LicenseRef-BAM-Charte-Diffusion"
]
},
"terms_url": {
"type": "string",
"format": "uri"
},
"terms_section": {
"type": "string",
"minLength": 1
},
"attribution": {
"type": "string",
"minLength": 1
},
"notice": {
"type": "string",
"minLength": 1
},
"reuse": {
"type": "object",
"additionalProperties": false,
"required": [
"non_commercial_use",
"commercial_use",
"modifications"
],
"properties": {
"non_commercial_use": {
"enum": [
"permitted-with-attribution-and-copy-date"
]
},
"commercial_use": {
"enum": [
"written-permission-required"
]
},
"modifications": {
"enum": [
"disclose-changes-and-BAM-non-liability"
]
}
}
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"sources": {
"type": "array",
"minItems": 2,
"maxItems": 2,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"filename",
"sheet",
"records",
"reference_date",
"date_basis",
"sha256"
],
"properties": {
"dataset": {
"type": "string",
"enum": [
"institutions",
"bank-codes"
]
},
"filename": {
"type": "string",
"minLength": 1
},
"sheet": {
"type": "string",
"minLength": 1
},
"records": {
"type": "integer",
"minimum": 1
},
"reference_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"date_basis": {
"type": "string",
"minLength": 1
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
},
"pagination": {
"type": "object",
"additionalProperties": false,
"required": [
"limit",
"offset",
"count",
"has_more",
"next_offset"
],
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 500
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 31
metaobjectسياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.
meta.datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"bam-banking"meta.producerstringالجهة التي تنشر البيانات الأصلية.
القيم المقبولة:
"Bank Al-Maghrib"meta.totalintegerعدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.
meta.received_atstringتاريخ رسالة بنك المغرب التي أرفقت الملفات، وهو مختلف عن تاريخ مرجع البيانات.
meta.copied_atstringتاريخ النسخ المذكور ضمن بيان نسبة البيانات إلى بنك المغرب.
meta.transformation_versionstringإصدار قواعد تحويل مجموعة البيانات؛ مستقل عن إصدار الواجهة.
meta.licensestringمعرّف محلي لشروط ميثاق بنك المغرب؛ ليس رخصة مفتوحة معيارية.
القيم المقبولة:
"LicenseRef-BAM-Charte-Diffusion"meta.terms_urlstringالميثاق الرسمي لبنك المغرب بشأن نشر البيانات والإحصاءات.
meta.terms_sectionstringقسم الميثاق الذي يحدد شروط إعادة الاستخدام.
meta.attributionstringبيان المصدر وتاريخ النسخ الواجب الاحتفاظ به عند إعادة الاستخدام.
meta.noticestringبيان التحويلات التي أجرتها MoroccoAPI وعدم مسؤولية بنك المغرب عنها.
meta.reuseobjectملخص شروط الميثاق؛ راجع النص المرتبط.
meta.reuse.non_commercial_usestringإعادة الاستخدام غير التجاري مع ذكر بنك المغرب وتاريخ النسخ.
القيم المقبولة:
"permitted-with-attribution-and-copy-date"meta.reuse.commercial_usestringالاستعمال التجاري وفق تعريف الميثاق يتطلب إذناً كتابياً من بنك المغرب.
القيم المقبولة:
"written-permission-required"meta.reuse.modificationsstringالإفصاح عن التعديلات وإدراج بيان عدم مسؤولية بنك المغرب.
القيم المقبولة:
"disclose-changes-and-BAM-non-liability"meta.limitationsstring[]القيود المعروفة للمصدر أو التغطية؛ اقرأها قبل استخدام البيانات.
meta.sourcesobject[]المصادر المستخدمة لهذه النتيجة مع الجهات المنتجة والرخص.
meta.sources[].datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"institutions""bank-codes"meta.sources[].filenamestringاسم الملف المرفق الذي أرسله بنك المغرب.
meta.sources[].sheetstringاسم ورقة ملف الجداول المصدر.
meta.sources[].recordsintegerعدد السجلات في الملف الأصلي قبل التصفية.
meta.sources[].reference_datestring | nullتاريخ مرجع المصدر، أو null عند عدم تحديده؛ راجع date_basis.
meta.sources[].date_basisstringsource-filename: التاريخ من اسم الملف؛ not-stated-in-workbook: التاريخ غير مذكور في الملف.
meta.sources[].sha256stringبصمة SHA-256 لتحديد الملف المرفق الأصلي؛ ملف الجداول الخام غير مرفق.
meta.paginationobjectمعلومات لتصفّح نتائج القائمة صفحة بصفحة.
meta.pagination.limitintegerالعدد الأقصى المطلوب في الصفحة: 100 افتراضياً و500 كحد أقصى.
meta.pagination.offsetintegerعدد النتائج المتجاوزة قبل هذه الصفحة بعد التصفية. تبدأ الصفحة الأولى من 0.
meta.pagination.countintegerعدد النتائج الموجودة فعلياً في هذه الصفحة.
meta.pagination.has_morebooleanتكون true إذا بقيت صفحة أخرى من النتائج.
meta.pagination.next_offsetinteger | nullقيمة offset للصفحة التالية؛ null عند النهاية. احتفظ بالمرشحات نفسها.
الأخطاء
400: معامل غير صالح أو مفقود.
تتضمن الأخطاء error.code وerror.message وerror.request_id.
errorobjectتفاصيل الطلب الفاشل؛ تحل محل data وmeta.
error.codestringرمز ثابت للخطأ، مثل RESOURCE_NOT_FOUND؛ استعمله في منطق التطبيق.
error.messagestringشرح مقروء للخطأ؛ استعمل code في منطق التطبيق.
error.request_idstringمعرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.