منصة مصرفي للمطورين

واجهة JSON للقراءة فقط للمعرفة والقوائم المنشورة على مصرفي: المصطلحات، الجهات الرقابية، المعايير الدولية، بيانات الأسواق مع مصادرها، الوظائف والفعاليات.

طلب الوصول إلى API اقرأ التوثيق

المنتجات

نقطة الوصول	الوصف	معاملات الاستعلام
`GET /api/v1/glossary`المصطلحات	المصطلحات المصرفية والمالية المنشورة بالعربية والإنجليزية مع مصدرها.	`q, page, per_page`
`GET /api/v1/glossary/{slug}`مصطلح	مصطلح منشور واحد.	`—`
`GET /api/v1/regulators`الجهات التنظيمية	الجهات الرقابية والإشرافية المنشورة.	`country, page, per_page`
`GET /api/v1/regulators/{slug}`جهة تنظيمية	جهة رقابية منشورة واحدة.	`—`
`GET /api/v1/standards`المعايير الدولية	ملخصات المعايير المنشورة مع الرابط الرسمي (لا يُستضاف النص الكامل).	`page, per_page`
`GET /api/v1/standards/{slug}`قياسي	معيار منشور واحد.	`—`
`GET /api/v1/data-series`سلسلة بيانات	آخر قيمة لكل سلسلة منشورة للأسواق أو الأسعار أو المؤشرات مع مصدرها وتاريخها.	`kind, page, per_page`
`GET /api/v1/data-series/{slug}`سلسلة بيانات	آخر قيمة لسلسلة واحدة.	`—`
`GET /api/v1/jobs`الوظائف	الوظائف المنشورة (الحقول العامة فقط).	`open, page, per_page`
`GET /api/v1/events`الفعاليات	الفعاليات المنشورة (الحقول العامة فقط).	`upcoming, page, per_page`

البدء

سجّل الدخول وأرسل طلب وصول إلى API يصف تطبيقك والبيانات التي تحتاجها.
بعد موافقة فريق مصرفي أنشئ مفتاحاً من صفحة المطور. يُعرض المفتاح مرة واحدة فقط، فاحفظه بأمان.
استدعِ نقاط الوصول عبر HTTPS باستخدام مفتاحك. يمكن إلغاء المفاتيح في أي وقت.

المصادقة

أرسل مفتاحك في ترويسة Authorization مع كل طلب، ولا تضع المفاتيح في شيفرة عامة أو روابط.

Authorization: Bearer msk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

الحدود والترقيم

لكل تطبيق حد للطلبات في الدقيقة (60 افتراضياً) يظهر في صفحة المطور، وتوضحه ترويستا X-RateLimit-Limit وX-RateLimit-Remaining.
القوائم مرقّمة عبر page وper_page (حتى 100 لكل صفحة)، وتتضمن الاستجابة meta وlinks (first وprev وnext وlast).
لا تُعاد إلا السجلات المنشورة، وتأتي قيم البيانات دائماً مع مصدرها وتاريخها، ويجب عرضهما معها.

مثال

curl --request GET \
  --url https://musrefy.net/api/v1/glossary?q=liquidity \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

{
  "data": [
    { "type": "glossary-terms", "id": "…", "attributes": { "term": { "ar": "…", "en": "…" }, "definition": { … }, "source": { … } }, "links": { … } }
  ],
  "meta": { "page": 1, "per_page": 25, "total": …, "last_page": … },
  "links": { "self": "…", "first": "…", "last": "…", "prev": null, "next": "…" }
}

الأخطاء

401	مفتاح مفقود أو غير صالح أو ملغى، أو وصول غير معتمد.
404	السجل غير موجود أو غير منشور.
429	تم بلوغ حد الطلبات؛ أعد المحاولة بعد عدد الثواني المذكور في ترويسة Retry-After.

{"errors": [{"status": "401", "title": "Unauthenticated", "detail": "…"}]}

الإصدارات

الإصدار الحالي هو v1 وهو جزء من كل مسار (/api/v1/…). لن تصدر التغييرات غير المتوافقة إلا في إصدار جديد يُعلن عنه مسبقاً. حالة المنصة

الوصول والتسعير والدعم

يُمنح الوصول إلى API عند الطلب بعد المراجعة، وتُتفق الشروط التجارية للأحجام الأكبر مع فريق مصرفي.

طلب الوصول إلى API تواصل معنا

اختر الدولة/الإقليم واللغة

منصة مصرفي للمطورين

المنتجات

البدء

المصادقة

الحدود والترقيم

مثال

الأخطاء

الإصدارات

الوصول والتسعير والدعم

جميع روابط مصرفي

مصرفي

الخدمات

مصرفي ميديا

استكشف

منتجات مصرفي

المعرفة والبيانات

المساعدة والدعم

السياسات

الجوائز والأثر والتراث

مرحباً بك في حسابك على مصرفي

المصادقة الثنائية

استعادة الحساب

اختر نوع الحساب

إنشاء حساب شخصيات