كيفية استخدام واجهة FlipLink API للتكاملات المخصّصة

إذا كنت تدير عشرات (أو مئات) الكتب التفاعلية، فإن القيام بكل شيء يدويًا عبر لوحة التحكم يصبح مرهقًا بسرعة. هنا يأتي دور واجهة FlipLink API — فهي تتيح لك إنشاء الكتب التفاعلية برمجيًا، وإدارة المنشورات، وسحب التحليلات، ووصل FlipLink بأدواتك وسير عملك القائم.

سواء كنت مطوّرًا يبني تكاملًا مخصّصًا أو قائد فريق يبحث عن أتمتة المهام المتكرّرة، يرشدك هذا الدليل إلى ما تستطيع الواجهة فعله وكيف تبدأ.

ما الذي تتيحه لك واجهة FlipLink API

تمنحك واجهة FlipLink REST API وصولًا برمجيًا إلى القدرات نفسها المتاحة في لوحة التحكم. بدلًا من النقر عبر واجهة المستخدم، ترسل طلبات HTTP وتستقبل استجابات JSON منظّمة.

إليك ما يمكنك إنجازه:

• إنشاء كتب تفاعلية ومستندات من ملفات PDF دون فتح لوحة التحكم
• تحديث إعدادات المنشورات مثل العناوين، والأوصاف، ونماذج التقاط العملاء المحتملين، وضوابط الوصول
• استرجاع التحليلات — المشاهدات، والزوّار الفريدون، ومتوسّط الوقت على الصفحة، والمزيد
• إدارة المنشورات بشكل مجمّع — أرشفة أو حذف أو تحديث عشرات الكتب التفاعلية في سكربت واحد
• تشغيل سير العمل بناءً على أحداث مثل التقاط عملاء محتملين جدد أو بلوغ عتبات المشاهدة

للاطّلاع على نظرة عامّة كاملة للميزات البرمجية، تفقّد صفحة ميزة الوصول إلى API.

الحصول على مفتاح API الخاص بك

قبل إجراء أي استدعاءات للواجهة، تحتاج إلى مفتاح API. إليك كيفية الحصول على واحد:

١. سجّل الدخول إلى لوحة تحكم FlipLink على go.fliplink.me ٢. انتقل إلى الإعدادات (Settings) → API ٣. اضغط إنشاء مفتاح API (Generate API Key) ٤. انسخ المفتاح واحفظه بأمان — تعامل معه كأنه كلمة مرور

يصادق مفتاح API على كل طلب. ضمّنه في ترويسة Authorization:

Authorization: Bearer YOUR_API_KEY

هام: لا تكشف مفتاح API أبدًا في كود من جانب العميل أو مستودعات عامّة. احتفظ به على جانب الخادم أو في متغيّرات بيئة.

حالات الاستخدام الشائعة للواجهة

إنشاء كتب تفاعلية بشكل مجمّع

هل لديك مجلّد يضمّ ٥٠ كتالوج منتجات تحتاج إلى أن تصبح كتبًا تفاعلية؟ بدلًا من رفعها واحدًا تلو الآخر، اكتب سكربتًا يدور على ملفات PDF لديك ويستدعي نقطة نهاية الإنشاء لكل منها. اجمع ذلك مع العمليات المجمّعة لأقصى قدر من الكفاءة.

سحب التحليلات إلى لوحة تحكمك الخاصّة

إذا كنت تتابع أداء التسويق في أداة مركزية — لوحة تحكم مخصّصة، أو Google Sheets، أو منصّة ذكاء أعمال — فيمكنك سحب بيانات المشاهدة والتفاعل من FlipLink عبر الواجهة ودمجها مع مقاييسك الأخرى.

إدارة المنشورات على نطاق واسع

تحتاج إلى تحديث العلامة التجارية على جميع كتبك التفاعلية بعد إعادة تسمية العلامة؟ أو أرشفة كتالوجات الربع الماضي؟ تتيح لك الواجهة تنفيذ تلك التحديثات دفعة واحدة دون النقر عبر كل منشور على حدة.

الاتّصال بمنصّات الأتمتة

اجمع الواجهة مع أدوات مثل Zapier وPabbly وMake لبناء سير عمل بلا كود. على سبيل المثال، إنشاء كتاب تفاعلي تلقائيًا عند وصول ملف PDF جديد إلى مجلّد محدّد في Google Drive. اطّلع على دليلنا حول توصيل FlipLink بمنصّات الأتمتة للحصول على تعليمات خطوة بخطوة، أو استكشف ميزة الأتمتة والتكاملات.

🚀

جرّب FlipLink مجاناً

حوّل ملف PDF خلال ثوانٍ. لا تسجيل ولا بطاقة ائتمان — ارفع ملفك وانطلق.

Drop your PDF here or click to browse

الحجم الأقصى 40MB

مثال: إنشاء كتاب تفاعلي عبر الواجهة

إليك مثال أساسي باستخدام curl لإنشاء كتاب تفاعلي جديد من ملف PDF:

curl -X POST https://api.fliplink.me/v1/publications \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@product-catalog.pdf" \
  -F "title=Spring Product Catalog" \
  -F "type=flipbook" \
  -F "visibility=public"

تعيد الواجهة استجابة JSON تتضمّن معرّف المنشور، وكود التضمين، ورابط المشاركة — كل ما تحتاجه لتوزيع الكتاب التفاعلي على الفور.

يمكنك أيضًا فعل الشيء نفسه في Python أو Node.js أو أي لغة تدعم طلبات HTTP. الواجهة هي REST قياسية، فهي تعمل مع أي حزمة تقنية تستخدمها بالفعل.

نقاط نهاية API المتاحة

تعيد جميع نقاط النهاية JSON وتتبع رموز حالة HTTP القياسية. تطبَّق حدود معدّل الطلبات — راجع وثائق API في لوحة التحكم للاطّلاع على العتبات الحالية.

متى تستخدم الواجهة مقابل لوحة التحكم

ليس كل شيء يستلزم استدعاء API. إليك إطار قرار بسيط:

• استخدم لوحة التحكم عند إنشاء كتاب تفاعلي واحد، أو ضبط إعدادات التصميم بصريًا، أو استكشاف التحليلات بشكل عابر
• استخدم الواجهة عند التعامل مع أكثر من خمسة منشورات في وقت واحد، أو التكامل مع أنظمة أخرى، أو أتمتة المهام المتكرّرة
• استخدم منصّات الأتمتة (Zapier/Make/Pabbly) عندما تريد قوّة بمستوى API دون كتابة كود

بالنسبة للفرق التي تدير كتالوجات المنتجات أو أي محتوى يُحدَّث بانتظام، تسترد الواجهة قيمتها بالوقت الموفّر بعد أوّل تشغيل مجمّع.

ابدأ البناء

تحوّل واجهة FlipLink API الأعمال اليدوية المملّة إلى سير عمل مؤتمت. سواء كنت تزامن التحليلات مع لوحة تحكم، أو تنشئ كتبًا تفاعلية بشكل مجمّع من خطّ إنتاج محتوى، أو تربط FlipLink بنظام إدارة علاقات العملاء لديك — تمنحك الواجهة التحكّم لبناء ما تحتاجه بالضبط.

جاهز للبدء؟ أنشئ حسابك المجاني في FlipLink وأنشئ مفتاح API اليوم. تفقّد الأسعار لمعرفة ما يتضمّنه الوصول إلى API.