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

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

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

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

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

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

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

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

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

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

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

يصادق مفتاح API على كل طلب. مرّره في ترويسة X-Api-Key:

X-Api-Key: YOUR_API_KEY

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

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

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

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

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

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

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

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

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

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

🚀

جرّب FlipLink مجاناً

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

Drop your PDF here or click to browse

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

الباقات المدفوعة من $39 ترفع هذا الحد إلى 150 MB.

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

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

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@product-catalog.pdf' \
  -F 'Name=Spring Product Catalog' \
  -F 'Title=Spring Product Catalog' \
  -F 'DocType=Flipbook'

تعيد الواجهة استجابة JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — تتضمّن معرّف المنشور ورابط المشاركة اللذين تحتاجهما لتوزيع الكتاب التفاعلي على الفور. هل لديك ملف PDF متاح على الإنترنت بالفعل؟ استبدله بـ POST /api/create-by-url ومرّر FileURL بدلًا من File.

يمكنك فعل الشيء نفسه في Python أو Node.js أو أي لغة تدعم HTTP. الواجهة هي REST قياسية بأجسام form-urlencoded (أو multipart)، فهي تعمل مع أي حزمة تقنية تستخدمها بالفعل. أمر واحد يجب تذكّره: تعود أخطاء التطبيق برمز HTTP 200 مع Result: "ERROR" (ولا تستخدم 401 إلا إخفاقات المصادقة)، لذا تفرّع بناءً على حقل Result.

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

هذه شريحة صغيرة فقط — الكتالوج الكامل لأكثر من 80 نقطة نهاية، كلٌّ منها بمعاملاته وكونسول "جرّبها" (Try-It) مباشر، موجود في مرجع API.

تعيد جميع نقاط النهاية JSON. حد المعدّل هو 300 طلب في الدقيقة لكل مفتاح API. راجع مرجع API للاطّلاع على كل نقطة نهاية، ومعاملاتها، ونموذج الأخطاء، ومسارات التبعية.

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

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

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

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

ابدأ البناء

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

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