v1.0API عام

وثائق الـ API

وصول للقراءة فقط إلى كتالوج منتجات منثار القابضة وفحص صحة الـ API. جميع النقاط الطرفية تُرجع JSON بتنسيق استجابة موحّد.

الرابط الأساسي

https://minthar.net/api/v1

المصادقة

غير مطلوبة — جميع النقاط الطرفية عامة

التنسيق

JSON

تنسيق الاستجابة

جميع الاستجابات تتبع هيكلاً موحداً يتضمن قيمة ok المنطقية، ومعرّف طلب فريد، وحمولة البيانات.

استجابة ناجحة

{
  "ok": true,
  "request_id": "req_abc123",
  "data": {
    "...": "..."
  }
}

النظام

GET/health

يُرجع حالة الـ API الحالية ورقم الإصدار والطابع الزمني للخادم.

مثال على الاستجابة

{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2026-02-21T12:00:00.000Z"
}

كتالوج المنتجات

GET/catalog

يُرجع جميع المنتجات والخدمات والمعايير مع دعم التصفية حسب النوع والموقع والمجال وترقيم الصفحات.

المعاملات

الاسم	النوع	مطلوب	الوصف
`type`	string servicesplatformsstandards	لا	تصفية حسب نوع المنتج
`site`	string holdings	لا	تصفية حسب الموقع
`domain`	string	لا	تصفية المعايير حسب مُعرّف المجال
`limit`	integer	لا(افتراضي: 100)	الحد الأقصى لعدد النتائج (أقصى 500)
`offset`	integer	لا(افتراضي: 0)	عدد النتائج المراد تخطيها لترقيم الصفحات

مثال على الاستجابة

{
  "ok": true,
  "data": {
    "items": [
      {
        "slug": "cybersecurity",
        "type": "services",
        "titleEn": "Cybersecurity",
        "price": 0
      }
    ],
    "total": 42,
    "limit": 100,
    "offset": 0
  }
}

للتكامل البرمجي، يمكنك الوصول إلى مواصفات OpenAPI 3.1 الخام مباشرة.

عرض مواصفات OpenAPI (JSON)

الاسم

النوع

مطلوب

الوصف

type

string

servicesplatformsstandards

لا

تصفية حسب نوع المنتج

site

string

holdings

لا

تصفية حسب الموقع

domain

string

لا

تصفية المعايير حسب مُعرّف المجال

limit

integer

لا(افتراضي: 100)

الحد الأقصى لعدد النتائج (أقصى 500)

offset

integer

لا(افتراضي: 0)

عدد النتائج المراد تخطيها لترقيم الصفحات

{ "ok": true, "data": { "items": [ { "slug": "cybersecurity", "type": "services", "titleEn": "Cybersecurity", "price": 0 } ], "total": 42, "limit": 100, "offset": 0 } }