توثيق الواجهة البرمجية

الواجهات

واجهة المتجر البرمجيةمتاحة الآن

https://api.matgrk.com/v1

الواجهة التي تخدم واجهات المتاجر المخصصة وتطبيقات الجوال: الكتالوج والبحث والسلة وإتمام الطلب وحسابات المتسوقين والطلبات.

واجهة الإدارةقيد التطوير

الجانب الإداري للمتجر: المنتجات والتصنيفات والمخزون والطلبات والفواتير والعروض والحملات ومفاتيح API.

واجهة مركز البياناتقيد التطوير

الاتصالات والربط والتدفقات والتشغيلات — نقل بيانات الكتالوج والمخزون والطلبات والعملاء بين matgrk وأنظمتك.

واجهة التقاريرقيد التطوير

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

تكامل ERPمعاينة تصميمية

لشركاء أنظمة ERP: هيّئ عملاءك، وغذِّ كتالوجاتهم، وزامن المخزون، واستقبل الطلبات المسلَّمة.

الويب هوكقيد التطوير

أحداث الطلبات والمدفوعات موقَّعة بـ HMAC. تتدفق اليوم بين خدمات matgrk، والاشتراك بنقطة استقبال خاصة بك مخطط له.

ابدأ بسرعة

١. احصل على مفتاح API
لكل متجر بيانات اعتماد خاصة به بحدّ طلبات خاص. يظهر المفتاح (mk_live_…) مرة واحدة عند إصداره ولا يحتفظ matgrk إلا ببصمته. إدارة المفاتيح من لوحة التحكم قادمة؛ واليوم يُصدَر المفتاح لمتجرك عند طلبه عبر الدعم.

٢. استبدله برموز

المفتاح نفسه لا يُرسَل إلا إلى مسارَي الرموز — وكل الطلبات الأخرى تستخدم رمز الوصول قصير العمر.

الطلب

curl -X POST https://api.matgrk.com/v1/auth/anonymous \
  -H "X-Api-Key: mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transport": "bearer", "scope": ["catalogue:read"]}'

الاستجابة

{
  "data": {
    "transport": "bearer",
    "accessToken": "eyJhbGciOi…",
    "refreshToken": "eyJhbGciOi…",
    "expiresIn": 900,
    "scope": ["catalogue:read"]
  }
}

٣. استدعِ الواجهة

curl https://api.matgrk.com/v1/catalogue/products \
  -H "Authorization: Bearer ACCESS_TOKEN"

جيد أن تعرف