Loading
في هذه المقالة، سوف تتعلم كيفية تكوين واستخدام واجهة برمجة التطبيقات العامة في systeme.io، بما في ذلك كيفية إنشاء مفاتيح API وما هي الإجراءات التي يمكن القيام بها.
1. ما هو API؟
يشير الاختصار API إلى "واجهة برمجة التطبيقات"، وهي سلسلة من التعليمات التي تقدم من خلالها منصة خدماتها لمنصات أخرى. إنها بوابة استراتيجية تتيح للمطورين الخارجيين الوصول إلى وظائف أو بيانات معينة من المنصة بشكل منظم وآمن. إنها كأدوات جاهزة للاستخدام تجعل من السهل بناء تطبيقات أو خدمات أو تركيبات جديدة.
باختصار، يفتح systeme.io أمام المنصات الأخرى لتقديم خدماتها حيث تضيف قيمة.
2. كيف تعمل واجهة برمجة التطبيقات العامة الخاصة بنا؟
تقوم واجهة برمجة التطبيقات الخاصة بنا بتقديم مجموعة من الميزات المختارة بعناية، مما يتيح للمطورين التفاعل مع منصتنا بشفافية وكفاءة. إذا كنت ترغب في معرفة المزيد عن كيفية عملها، يمكنك قراءة الوثائق الرسمية لواجهة برمجة التطبيقات.
3. كيفية إنشاء مفاتيح API الخاصة بك
مفاتيح API هي معرفات فريدة تصادق الطلبات إلى واجهة برمجة التطبيقات العامة الخاصة بنا. تمكنك من الوصول برمجيًا إلى الموارد المختلفة على منصتنا وإدارتها.
لإنشاء مفتاح API عام، اضغط على صورة ملفك الشخصي، اختر الإعدادات (1)، ثم مرر لأسفل إلى المفاتيح والمفاتيح العامة لواجهة برمجة التطبيقات (2).
اضغط على إنشاء (3) لبدء إنشاء مفتاح API عام.
في نافذة إنشاء مفتاح API العام المنبثقة، أدخل اسمًا، وحدد تاريخ ووقت انتهاء صلاحية لمفتاح API الخاص بك.
عند الانتهاء، اضغط على حفظ (4).
ملاحظة: لكي يبقى مفتاح API الخاص بك نشطًا لإلى أجل غير مسمى، اترك حقل 'انتهاء الصلاحية' فارغًا.
المفتاح الخاص بك جاهز الآن.
4. ماذا يمكنك أن تفعل بواجهة برمجة التطبيقات الخاصة بنا؟
واجهتنا تفتح بعض الإمكانيات المثيرة. فيما يلي الإجراءات الرئيسية التي يمكنك القيام بها باستخدام واجهة برمجة التطبيقات العامة لدينا:
أ. جهات الاتصال، العلامات، والحقول المخصصة:
إدارة جهات الاتصال: إنشاء جهات اتصال جديدة، تحديث جهات الاتصال الحالية، قائمة جمهورك باستخدام فلاتر متقدمة، أو حذف جهات الاتصال.
إدارة العلامات: إنشاء، تعيين، قائمة، وإزالة العلامات من جهات الاتصال.
الحقول المخصصة: الحصول على الحقول المخصصة المتاحة لجهة الاتصال ومعرفاتها (slugs) لملء معلومات جهة الاتصال بشكل صحيح.
ب. النشرات الإخبارية:
إنشاء وتحديث النشرات الإخبارية: إنشاء مسودات نشرات إخبارية جديدة أو تحديث النشرات الحالية جزئيًا. يمكنك تحديد نوع المحرر (كلاسيكي أو بصري)، واسترجاع محتوى HTML بالكامل، وتعيين اسم المرسل وعنوان بريده بشكل صريح.
قائمة واسترجاع: تصفح النشرات الإخبارية الموجودة لديك أو الحصول على المحتوى الكامل لنشرة إخبارية معينة باستخدام معرفها.
ج. الأنفاق ومحرر الصفحات:
إدارة الأنفاق: إنشاء أنفاق جديدة، إضافة خطوات جديدة (صفحات) لها، والحصول على قائمة بجميع الخطوات الفردية داخل نفق معين.
محرر الصفحات: حفظ محتوى صفحات المنشأة مباشرة إلى خطوات النفق أو صفحات الموقع الإلكتروني (استبدال كامل)، والحصول على مخططات JSON لنماذج صفحات محددة.
د. خطط الأسعار والقسائم:
إنشاء، تحرير، وحذف: إنشاء خطط أسعار وقسائم جديدة، أو تحديثها جزئيًا وحذفها.
قائمة والبحث: تصفح جميع خطط الأسعار والقسائم الحالية لديك، أو الحصول على عناصر معينة بواسطة معرفها.
هـ. الدورات والطلاب:
إدارة الدورات والطلاب: الحصول على قائمة الدورات الحالية واسترجاع قائمة الطلاب المسجلين حاليًا.
تسجيل الطلاب: تسجيل جهات الاتصال برمجيًا في دوراتك الفردية.
ملاحظة عن الدورات: سيتم إضافة دعم لحزم الدورات في التحديثات المستقبلية.
و. المجتمعات:
إدارة المجتمعات: استرجاع قائمة المجتمعات الحالية لديك، والوصول إلى قائمة الأعضاء الحاليين داخل مجتمع محدد.
دعوة الأعضاء: دعوة مستخدمين جدد للانضمام إلى مجتمعاتك برمجيًا عن طريق تقديم معرف جهة الاتصال الخاص بهم.
ز. قواعد الأتمتة:
إدارة القواعد: ربط الأحداث الشائعة والإجراءات برمجيًا، تحديث القواعد الحالية (مثل تغيير إجراء بينما يتم الاحتفاظ بالمحفز نفسه)، أو حذف القواعد برفق.
قائمة واسترجاع: تصفح قواعد الأتمتة الخاصة بك أو الحصول على قاعدة معينة بواسطة معرفها.
ح. الاشتراكات:
إدارة الاشتراكات: استرجاع قائمة بجميع الموارد في اشتراك من منصات الطرف الثالث، وإلغاء الاشتراك إما فورًا أو في نهاية دورة الفواتير.
ط. نقاط التوزيع (Webhooks)
إدارة نقاط التوزيع: إنشاء نقاط توزيع جديدة برمجيًا لتلقي إشعارات في الوقت الفعلي، استرجاع قوائم نقاط التوزيع الحالية، وإزالة نقاط التوزيع غير المطلوبة.
ملاحظات:
لتسهيل تحديد وإدارة الرموز المميزة الخاصة بك، يجب أن يكون لكل منها اسم فريد.
يمكن نسخ الرمز المميز فقط بعد إنشائه مباشراً. إذا نسيت نسخ الرمز المميز الخاص بك، فاحذفه وأنشئ واحدًا جديدًا.
وكإجراء أمني، سنرسل لك إشعارًا عبر البريد الإلكتروني كلما تم إنشاء مفتاح واجهة برمجة التطبيقات عام جديد في حسابك على systeme.io.
يمكنك إنشاء ما يصل إلى 3 مفاتيح API لكل حساب.
تعرف على المزيد: الوثائق الخاصة بـ API.