استعلام بيانات SDMX القياسي
استرجاع بيانات السلاسل الزمنية المنشورة بصيغة SDMX-JSON مبسّطة (المواصفة الكاملة قيد الإعداد)، مع الفلترة بالوكالة المصدرة والتدفق والإصدار ومفتاح السلسلة والنطاق الزمني. السجل المنشور يضم حالياً — سلسلة عبر أربعة تدفقات سيادية.
كل استجابة تحمل ترويسة X-CBI-Flow المؤكدة للتدفق المصدر. التوقيع الرقمي X-CBI-Signature لضمان أصالة البيانات السيادية يفعل مع بوابة SDMX على السيرفر المستقل — بانتظار تزويد الدائرة.
الاستيثاق: الوصول العام متاح بلا مفتاح ولا ترويسة استيثاق. الوصول المؤسسي الموسع (حصص أعلى وقنوات مخصصة) عبر طلب اعتماد مؤسسي يقدم إلى دائرة الإحصاء والأبحاث.
alt_routeمعلمات المسار (Path Parameters)
| المعلمة | النوع | الوصف | مثال |
|---|---|---|---|
| agency* | string | معرف الوكالة المصدرة — CBI حصراً في هذا المستودع | CBI |
| flow* | string | معرف تدفق البيانات: DF_MONETARY أو DF_REAL أو DF_EXTERNAL أو DF_FISCAL، أو EXR (تجريبي — يرجع 404 صادقاً) | DF_MONETARY |
| version* | string | إصدار تعريف التدفق — 1.0 حالياً | 1.0 |
| key* | string | معرف السلسلة في السجل المركزي أو رمزها القديم أو ALL لكل سلاسل التدفق | CBI-MON-029 · S053 · ALL |
tuneمعلمات الاستعلام (Query Parameters)
| المعلمة | النوع | الوصف | مثال |
|---|---|---|---|
| startPeriod | string | بداية النطاق الزمني بصيغة دورية السلسلة: شهري YYYY-MM، فصلي YYYY-Qn، سنوي YYYY، يومي YYYY-MM-DD | 2023-01 |
| endPeriod | string | نهاية النطاق الزمني — بذات صيغة الدورية، وتقارن نصياً تصاعدياً | 2024-12 |
terminalمثال الطلب
curl -X GET "https://stats.yammak.app/api/v1/sdmx/data/CBI,DF_MONETARY,1.0/CBI-MON-029?startPeriod=2023-01&endPeriod=2024-12" \ -H "Accept: application/json"
المفتاح CBI-MON-029 في المثال سلسلة حقيقية من السجل المركزي (عرض النقد الواسع M2)، ويقبل المفتاح الرمز القديم S053 أو ALL لكل سلاسل التدفق.
account_treeمخطط الاستجابة
بيان الصدق: صيغة SDMX-JSON مبسّطة — المواصفة الكاملة قيد الإعداد وتفعل مع بوابة SDMX على السيرفر المستقل.
reportرموز الأخطاء
| الرمز | الدلالة | مثال الاستجابة |
|---|---|---|
| 400 | طلب غير صالح صيغة فترة لا تطابق دورية السلسلة أو مسار ناقص المقاطع | { "error": "صيغة startPeriod غير صالحة — الشهري يتبع YYYY-MM" } |
| 404 | تدفق أو سلسلة غير موجودة تدفق خارج القائمة الشرعية، أو مفتاح لا يطابق سلسلة منشورة، أو EXR التجريبي (فارغ بصدق) | { "error": "تدفق غير معروف: DF_X — المتاح: DF_MONETARY, DF_REAL, DF_EXTERNAL, DF_FISCAL, EXR" }{ "error": "لا سلسلة تطابق المفتاح S999 في DF_MONETARY" }{ "error": "تدفق EXR تجريبي — سلاسل أسعار الصرف بانتظار تسجيلها الرسمي في السجل المركزي", "status": "EXPERIMENTAL_EMPTY" } |
| 429 | تجاوز حد الطلبات الاستخدام العام مكفول بلا مفتاح ضمن حدود عادلة — الإنفاذ الكمي الكامل يفعل مع السيرفر المستقل | { "error": "تجاوز حد الطلبات — أعد المحاولة بعد المهلة", "retry_after": 60 } |
| 500 | خطأ داخلي عطل غير متوقع في حافة النشر — يسجل ويبلغ فريق التشغيل | { "error": "خطأ داخلي — سجلت الحادثة وأبلغ فريق التشغيل" } |