البحث عن رمز بنكي
معلومة مهمة. ملفات أرسلها بنك المغرب في 4 نونبر 2026: قائمتان منفصلتان للمؤسسات والرموز البنكية دون مطابقة تلقائية. يشترط الميثاق ذكر المصدر وتاريخ النسخ؛ والاستعمال التجاري يتطلب إذناً كتابياً. تُحفظ البيانات الأصلية بالفرنسية.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 8
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobjectالنتيجة المطلوبة: كائن واحد أو قائمة.
data.codestringرمز بنك المغرب من ثلاثة أرقام مع الأصفار الأولى، ويختلف عن SWIFT/BIC.
data.namestringالاسم الفرنسي محفوظ كما ورد في ملف بنك المغرب.
data.category_codestringرمز الصنف لدى MoroccoAPI داخل هذا المرجع.
data.category_namestringاسم الصنف محفوظ كما أورده بنك المغرب.
data.source_refobjectموضع المشاهدة داخل المصدر: ورقة/سطر أو حوض/ترتيب.
data.source_ref.sheetstringاسم ورقة ملف الجداول المصدر.
data.source_ref.rowintegerرقم السطر في ملف المصدر، بدءاً من 1.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"name",
"category_code",
"category_name",
"source_ref"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[0-9]{3}$",
"description": "Three-digit BAM bank code, preserving leading zeros. Not a SWIFT/BIC code."
},
"name": {
"type": "string",
"minLength": 1
},
"category_code": {
"type": "string",
"minLength": 1
},
"category_name": {
"type": "string",
"minLength": 1
},
"source_ref": {
"type": "object",
"additionalProperties": false,
"required": [
"sheet",
"row"
],
"properties": {
"sheet": {
"type": "string",
"minLength": 1
},
"row": {
"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"
],
"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}$"
}
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 25
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 لتحديد الملف المرفق الأصلي؛ ملف الجداول الخام غير مرفق.
الأخطاء
400: معامل غير صالح أو مفقود.404: المورد غير موجود.
تتضمن الأخطاء error.code وerror.message وerror.request_id.
errorobjectتفاصيل الطلب الفاشل؛ تحل محل data وmeta.
error.codestringرمز ثابت للخطأ، مثل RESOURCE_NOT_FOUND؛ استعمله في منطق التطبيق.
error.messagestringشرح مقروء للخطأ؛ استعمل code في منطق التطبيق.
error.request_idstringمعرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.