الإدارة

واجهة برمجية صغيرة وصريحة لأدواتك

قراءة بمفتاح لبيانات فرعك وفريقك ومزودي الدفع، وWebhooks لتغييرات الفرع والفريق والاشتراك.

آخر تحديث

ماذا تحصل عليه

  • مفاتيح لكل فرع

    أنشئ مفاتيح API من إعدادات الفرع. كل مفتاح يخص فرعاً واحداً، ويُخزَّن مشفّراً بالتجزئة، ويمكن أن يحمل تاريخ انتهاء.

  • نقاط قراءة

    اقرأ تفاصيل فرعك وأعضاء الفريق ومزودي الدفع الفعّالين عبر الإصدار 1 من الواجهة.

  • Webhooks مع سجل

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

  • سجل الاستخدام

    يُسجَّل كل طلب مقابل مفتاحه مع الطريقة والمسار والحالة وزمن الاستجابة.

  • حدود حسب الباقة

    Starter فيها مفتاح واحد وWebhook واحد، وGrowth خمسة من كل منهما، وUnlimited بلا حد.

في هذه الصفحة
  1. ماذا تفعل
  2. كيف تعمل
  3. ما الذي تغطيه Webhooks
  4. الباقات
  5. إذا احتجت إلى بيانات الطلبات
  6. ما الذي تحل محله

ماذا تفعل

لدى DineHarbor واجهة برمجية عامة صغيرة للباقات التي تتضمنها. صُممت للأدوات التي تحتاج إلى معرفة الفرع الذي تعمل معه. وهي لا تتيح بعد طلباتك أو قائمتك أو مدفوعاتك، وتقول هذه الصفحة ذلك بوضوح لتقرر هل تكفيك.

كيف تعمل

  1. في Manager افتح إعدادات الفرع وأنشئ مفتاح API. يبدأ كل مفتاح بـ wsk_ ويخص فرعاً واحداً.
  2. اختر صلاحياته. كل نقطة متاحة اليوم تحتاج صلاحية القراءة. أما الصلاحيات الأخرى فموجودة لنقاط مستقبلية ولا يجري التحقق منها بعد.
  3. استدعِ نقاط الإصدار 1 بالمفتاح: فرعك وأعضاءه ومزودي الدفع فيه.
  4. راجع سجل الاستخدام في الإعدادات لترى كل طلب وحالته ووقته.
  5. لاستقبال Webhooks أضف نقطة استقبال ضمن الإعدادات ثم المطورين والتكاملات، واستعن بدليل التوقيع للتحقق من الرسائل المسلَّمة.

ما الذي تغطيه Webhooks

تعلن Webhooks عن تغييرات الفرع وفريقه واشتراكه: BranchUpdated وBranchMemberAdded وBranchMemberRemoved وBranchMemberRoleUpdated وSubscriptionUpdated. ولا تعلن عن الطلبات أو المدفوعات أو تغييرات القائمة. يُعاد إرسال التسليم الفاشل حتى ثلاث مرات في المجموع مع فاصل متزايد، ولأنه لا توجد ترويسة لمعرّف التسليم بعد، ينبغي أن يكون معالجك آمناً إذا نُفّذ مرتين بالمحتوى نفسه.

الباقات

تتضمن Starter مفتاح API واحداً وWebhook واحداً، وتتضمن Growth خمسة من كل منهما، وUnlimited بلا حد.

إذا احتجت إلى بيانات الطلبات

الطلبات والمدفوعات والقائمة متاحة داخل DineHarbor، في Manager وتقاريره، لكن ليس عبر الواجهة العامة اليوم. أخبرنا على sales@dineharbor.com بما تريد ربطه، فهذا يحدد ما سنبنيه لاحقاً. وثائق المطورين بالإنجليزية.

ما الذي تحل محله

لا شيء بعد، ولا تحاول ذلك. إنها نقطة بداية لمراقبة الفروع والفرق من أدواتك، ومكان تنمو فيه الواجهة.

أسئلة وأجوبة

هل أستطيع قراءة الطلبات أو إنشاءها عبر الواجهة؟

ليس اليوم. تقرأ الواجهة فرعك وأعضاءه ومزودي الدفع فيه. لا توجد نقطة للطلبات أو المدفوعات أو القائمة بعد.

ما الأحداث التي ترسلها Webhooks؟

تحديثات الفرع، وإضافة عضو إلى الفرع أو إزالته أو تحديث دوره، وتحديثات الاشتراك. لا توجد أحداث للطلبات أو المدفوعات أو القائمة بعد.

ماذا يحدث إذا فشلت نقطة الاستقبال لدي؟

يُعاد إرسال أي رد غير 2xx حتى ثلاث مرات في المجموع مع فاصل متزايد. لا يوجد ترويسة لمعرّف التسليم بعد، لذا اجعل معالجك آمناً عند التكرار.

أين التوثيق؟

في وثائق المطورين على /docs، وهي بالإنجليزية فقط.

ميزات ذات صلة

لنوع نشاطك

مقارنات

اقرأ المزيد

ضع قائمتك على الإنترنت اليوم.

صوّر قائمتك، وراجع الأسعار، وابدأ باستقبال طلبات دون عمولة. كل الميزات مجانًا لمدة 30 يومًا، دون بطاقة ودون تثبيت أي شيء.

دون بطاقة · ألغِ متى شئت