← مساري لينك

واجهة المطورين (API)

اربط صفحتك ومتجرك بموقعك أو تطبيقك أو أنظمتك. الردود كلها JSON، والنصوص UTF-8. استبدل USERNAME باسم رابط صفحتك.

القراءة والحجوزات

GET/api/v1/products?username=USERNAMEعام

منتجات المتجر المنشورة: الاسم، السعر، السعر قبل الخصم، التوفر، الصورة ورابط المنتج.

curl "https://masarilink.store/api/v1/products?username=USERNAME"
GET/api/v1/pages?username=USERNAMEعام

بيانات الصفحة المنشورة: العنوان، النبذة، العناصر والحسابات.

curl "https://masarilink.store/api/v1/pages?username=USERNAME"
GET/api/posts?public=1&username=USERNAME&n=10عام

آخر مقالات المدونة (العنوان والرابط والغلاف).

curl "https://masarilink.store/api/posts?public=1&username=USERNAME&n=10"
GET/USERNAME/store/feed.xmlعام

ملف المنتجات لقوقل ميرشنت وميتا وتيك توك (وبصيغة CSV مع ?format=csv).

curl "https://masarilink.store/USERNAME/store/feed.xml"
POST/api/v1/bookingsعام

تسجيل حجز على صفحة منشورة: username, serviceName, clientName, clientPhone, date (YYYY-MM-DD), time, notes.

curl -X POST "https://masarilink.store/api/v1/bookings" -H "Content-Type: application/json" -d '{"username":"USERNAME","clientName":"سارة","clientPhone":"0551234567","date":"2026-12-01","time":"16:00"}'
GET/api/v1/bookings?username=USERNAMEصاحب الصفحة

آخر 50 حجز (يحتاج تسجيل دخول صاحب الصفحة).

من المتصفح وأنت مسجل دخول

التنبيهات الفورية (Webhooks)

من لوحة التحكم ← تبويب «الأتمتة» أضف رابط Webhook (https) لأي حدث: order.created، booking.created، lead.created. يوصلك POST بهالشكل:

{
  "event": "order.created",
  "test": false,
  "page": "USERNAME",
  "sentAt": "2026-10-01T12:00:00.000Z",
  "data": { "orderNumber": "ML-261001-ABC123", "name": "…", "phone": "…", "product": "…", "total": "120 ر.س" }
}

تأكد إنه منّا من الترويسة X-Masarilink-Signature: sha256=… (HMAC-SHA256 للنص بالمفتاح السري اللي يطلع لك مع الأتمتة). وتقدر تربط Google Sheets بدون برمجة من تبويب «النمو».

مفاتيح الربط (API Keys) و MCP

القراءة العامة فوق ما تحتاج مفتاح. لربط مركز NFC (الدخول، الحضور، الزوار، الأصول) بأنظمتك أو بوكيل ذكاء اصطناعي: من لوحة التحكم ← تبويب «NFC» ← «المطورين: API و MCP» أنشئ مفتاح خاص، وأرسله في الترويسة Authorization: Bearer …. المفتاح يطلع مرة وحدة، وتقدر توقفه وقت ما تبي.

ربط موقعك بالعملاء (باقة الأعمال)

من لوحة التحكم ← «العملاء» ← «🔗 اربط موقعك». أي عميل يوصل بأي طريقة من الثلاث ينحفظ في «العملاء» بوسم «موقعي» مع تنبيه، وإذا رجع بنفس الجوال أو الإيميل تنضاف رسالته لنفس العميل.

  1. نموذج جاهز: سطر واحد تلصقه في موقعك، يطلع النموذج ويتعدل طوله لحاله. تقدر تقصره على مواقعك بس.
  2. رابط الاستقبال: رابط سري تحطه في نماذجك الحالية (Elementor و WPForms و Contact Form 7 و Zapier و Make). يقبل JSON أو form-urlencoded بأي أسماء خانات بالعربي أو الإنجليزي، ويفهم fields[name][value]. لو وصله أكثر من ١٢٠ طلب في ساعة يتوقف لحاله.
  3. الواجهة البرمجية: مفتاح يبدأ بـ msk_ld_ يشتغل على صفحة وحدة.
POST /api/v1/leads
Authorization: Bearer msk_ld_…
Content-Type: application/json

{ "name": "…", "phone": "05…", "email": "…", "message": "…",
  "company": "…", "page_url": "https://yoursite.com/offer?utm_source=google&utm_campaign=…",
  "source": "…",        // optional: the channel name you want shown
  "any_other_field": "…" }

→ 201 { "success": true, "id": "…", "merged": false }
→ 200 { "success": true, "id": "…", "merged": true }   // same phone/email within the merge window

GET /api/v1/leads?since=2026-11-01T00:00:00Z&limit=50   (max 200, newest first)

المصدر: إذا أرسلت page_url أو utm_source و utm_campaign أو معرّفات النقر (gclid، fbclid، ttclid، ScCid)، يطلع مع العميل «الصفحة» و«جاء من» و«الحملة». الحد: ٦٠٠ طلب بالساعة لكل مفتاح، و٥٠٠ عميل باليوم لكل صفحة.

مركز الربط

في لوحة التحكم «مركز الربط» يجمع كل طرق الربط، مع برمجة وبدونها: نقل المنتجات من سلة وزد، ملفات CSV للمحاسب، Webhooks، Google Sheets، التقويم، أدوات التتبع، تيك توك وواتساب، مع حالة كل واحد وخطواته. مركز المساعدة

سوق الإضافات

عندك أداة على موقعك؟ قدّمها كإضافة تشتغل داخل إطار معزول، وبعد مراجعة الفريق يضيفها أصحاب الصفحات كعنصر. سوق الإضافات

الحدود

  • القراءة العامة مخزنة دقيقة (Cache) وتعطيك الصفحات المنشورة فقط.
  • الحجز من الـ API محدود بعدد طلبات لكل IP.
  • ما نعرض أبداً روابط التحميل الخاصة ولا بيانات العملاء في الروابط العامة.