تصوير: Domenico Loia / Unsplash
⚙️ الإعدادات

مفتاح الـ API والـ Webhooks للمطورين

خد مفتاح الـ API بتاع متجرك للربط من السيرفر، وابعت أحداث الطلبات لحظة بلحظة لسيرفرك عن طريق الـ Webhooks.

⏱ 2 دقيقة قراءة🖼 2 صورةآخر تحديث:
🖥️ افتح في لوحة التحكم/dashboard/settings?section=api

لو إنت أو المطوّر بتاعك عايزين تربطوا فونديرا بأنظمتكم — برنامج ERP، أو برنامج حسابات، أو نظام مخازن، أو تطبيق خاص — عندك أداتين. رمز الAPI بيخلي السيرفر بتاعك يقرا ويعدّل بيانات المتجر عن طريق Vondera API. والويب هوكس (Webhooks) بتعمل العكس: فونديرا بتكلّم السيرفر بتاعك أول ما حاجة تحصل، زي طلب جديد أو طلب اتعدّل.

هتلاقيهم تحت الإعدادات › المطور والإعدادات › ويب هوكس. الوصول للـ API ميزة في باقة Pro.

استخدام مفتاح الـ API

١ المطور · ٢ رمز الAPI (زرار النسخ) · ٣ ملاحظة هيدر Authorization · ٤ وثائق مفتاح API
١ المطور · ٢ رمز الAPI (زرار النسخ) · ٣ ملاحظة هيدر Authorization · ٤ وثائق مفتاح API
ويب هوكس: كل ويب هوك بالمحفز والطريقة والحالة (لينكات نقطة النهاية مخفية)
ويب هوكس: كل ويب هوك بالمحفز والطريقة والحالة (لينكات نقطة النهاية مخفية)
  1. افتح الإعدادات › المطور.
  2. انسخ رمز الAPI.
  3. ابعته في هيدر Authorization في طلبات الـ API اللي بتطلع من السيرفر.
  4. اضغط وثائق مفتاح API علشان تشوف الـ endpoints المتاحة وشكل الطلبات.
رمز الAPI
مفتاح الـ API السري بتاع متجرك، ومعاه زرار نسخ.
وثائق مفتاح API
بيفتح توثيق Vondera API.
إبطال مفتاح API
بيلغي المفتاح الحالي. أي ربط بيستخدمه هيقف لحد ما تحدّثه بمفتاح جديد.
ℹ️ معلومة مهمةاتعامل مع مفتاح الـ API كأنه باسورد. استخدمه على السيرفر بس — أبدًا مش في كود الموقع أو تطبيقات الموبايل أو أي كود منشور. لو اتسرّب، اضغط إبطال مفتاح API فورًا.

إنشاء ويب هوك

  1. افتح الإعدادات › ويب هوكس واضغط إنشاء ويب هوك.
  2. اديله اسم واضح واختار الحدث اللي يشغّله، مثلًا orders.created أو orders.updated.
  3. اكتب رابط نقطة النهاية — العنوان على السيرفر بتاعك اللي هيستقبل الحدث.
  4. احفظ. الـ Webhook هيظهر في القائمة بحالة نشط.
العنوان
اسم علشان تعرف الـ Webhook.
المحفز
الحدث اللي بيشغّل الـ Webhook، مثلًا orders.created (طلب جديد) أو orders.updated (طلب اتغيّر).
رابط نقطة النهاية
عنوان السيرفر بتاعك اللي بيستقبل بيانات الحدث.
الطريقة
طريقة إرسال البيانات — POST.
الحالة
الـ Webhook شغال دلوقتي ولا لأ.
البحث في الويب هوكس
دوّر على Webhook بالاسم.
💡 نصيحةالتطبيقات اللي بتنزّلها من متجر التطبيقات بتسجّل الـ Webhooks بتاعتها هنا باسم App: <اسم التطبيق>. سيبها زي ما هي — لو مسحت واحد ممكن التطبيق يبطّل يشتغل. لو عايز توقف تطبيق، شيله أو عدّل إعداداته من متجر التطبيقات.

أسئلة شائعة

مش لاقي مفتاح الـ API. ليه؟

الوصول للـ API موجود في باقة Pro. راجع باقتك من الإعدادات › الاشتراك.

السيرفر بتاعي يعمل إيه لما يوصله Webhook؟

يرد بسرعة برد نجاح، وبعدين يعمل أي معالجة تقيلة في الخلفية. واتأكد إن اللينك عام وبيستخدم HTTPS.

أستخدم الـ API ولا الـ Webhooks؟

استخدم الـ Webhooks علشان تتفاعل مع الأحداث أول ما تحصل، والـ API علشان تجيب أو تعدّل بيانات وقت ما تحتاج. أغلب الربطات بتستخدم الاتنين.

لسه محتاج مساعدة؟

فريق الدعم متاح من ١١ الصبح لـ ٧ بالليل (بتوقيت مصر)، من السبت للخميس.