الانتقال إلى المحتوى
راي.ما
اكتب رأيك

البيانات العامة لراي.ما

مجموعة بيانات مفتوحة للشركات المغربية والآراء المواطنة الموثَّقة. ترخيص CC-BY 4.0 (ODbL للبيانات الجغرافية من OpenStreetMap).

1. الوصول إلى البيانات

ثلاث قنوات للوصول إلى مجموعة البيانات، من الأبسط إلى الأغنى:

  • JSON كامل (أعلى 1000 شركة حسب درجة الثقة): /api/public/v1/donnees-publiques
  • API REST عمومية: /api/public/v1/* (businesses, reviews, alerts, cities, catégories, stats).
  • خادم MCP للذكاء الاصطناعي (Claude، Cursor، إلخ): mcp.rayi.ma (قريبا).

2. التحقق والحصص

نقاط النهاية العمومية تقبل ترويسة x-rayima-key: sk_rayi_... أو Authorization: Bearer sk_rayi_.... بدون مفتاح، يُطبَّق المستوى المجاني حسب IP.

المستوىالحصة/query (RAG)
مجاني (مجهول)500 طلب/ساعة لكل IPلا
مجاني (بمفتاح)1,000 طلب/يوملا
Pro50,000 طلب/شهرنعم
Business500,000 طلب/شهرنعم

كل استجابة تتضمن الترويسات X-RateLimit-Remaining و Link.

3. مخطط البيانات

كل إدخال شركة يكشف الحقول التالية:

  • id (uuid)
  • slug (url-safe)
  • name، city، category
  • trust_score (0 إلى 5)
  • review_count (int)
  • last_activity_at (ISO 8601)

4. الترخيص والإسناد

مجموعة البيانات متاحة بموجب ترخيص Creative Commons Attribution 4.0 International (CC-BY 4.0).

الإسناد المطلوب: «المصدر: راي.ما» مع رابط إلى https://rayi.ma.

البيانات الجغرافية المستوردة من OpenStreetMap تظل خاضعة لترخيص ODbL. اطلع على صفحة التراخيص والمصادر للتفاصيل الكاملة.

الحصول على مفتاح API

واجهة الخدمة الذاتية في طور النشر. تواصل معنا للوصول المبكر إلى المستويات Pro و Business، أو لخطة Enterprise مخصصة.

طلب الوصول