كيفية أتمتة إنشاء الكتب التفاعلية عبر FlipLink API

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

لماذا تُؤتمت إنشاء الكتب التفاعلية؟

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

تتيح الأتمتة عدة مزايا:

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

البدء مع FlipLink API

المصادقة

يتطلب كل طلب API مفتاحًا للمصادقة. يمكنك توليد مفتاحك من لوحة تحكم FlipLink ضمن الإعدادات (Settings) > وصول API (API Access). مرّر المفتاح في ترويسة X-Api-Key مع كل طلب:

X-Api-Key: YOUR_API_KEY

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

عنوان URL الأساسي وحدود المعدّل

تُقدَّم جميع نقاط نهاية API من عنوان URL الأساسي https://go.fliplink.me/api. تُطبَّق حدود المعدّل لكل مفتاح API (300 طلب/دقيقة)، لذا إذا كنت تشغّل عمليات دفعية فأدرج تأخيرات صغيرة بين الطلبات للبقاء ضمن الحد المسموح. تُعيد إخفاقات المصادقة رمز HTTP 401؛ أمّا في كل حالة أخرى فتستجيب الواجهة برمز HTTP 200 وجسم JSON يكون حقله Result فيه "OK" أو "ERROR" — لذا تفرّع دائمًا بناءً على Result، لا على رمز الحالة وحده. تصفّح قائمة نقاط النهاية الكاملة، مع أمثلة مباشرة، في مرجع API.

رفع ملفات PDF برمجيًا

جوهر إنشاء الكتب التفاعلية الآلي هو نقطة نهاية Create by File، أي POST /api/create-by-file. ترسل ملف PDF بصيغة رفع نموذج multipart، ويُعالجه FlipLink ليصبح كتابًا تفاعليًا. إذا كان ملف PDF لديك موجودًا بالفعل على عنوان URL عام، فاستخدم POST /api/create-by-url بدلًا من ذلك ومرّر FileURL بدلًا من File.

يتضمن طلب الرفع النموذجي:

• ملف PDF (File، بيانات ثنائية عبر نموذج multipart)
• اسم Name (داخلي) وعنوان Title (للعرض) للكتاب التفاعلي
• النوع DocType (مثل Flipbook)

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

يُعيد الاستدعاء الناجح {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} مع حصّة النشر المتبقية لديك (Flipbooks_Left). التقط ID — فستستخدمه بوصفه معامل المسار {flipbookId} في كل استدعاء تهيئة أدناه.

تهيئة إعدادات الكتاب التفاعلي عبر API

رفع ملف PDF ليس سوى الخطوة الأولى. تتيح لك الواجهة أيضًا ضبط كل إعداد قد تعدّله عادةً في لوحة التحكم. وبدلًا من استدعاء تحديث شامل واحد، يوفّر FlipLink نقطة نهاية set-* مركّزة لكل مجموعة إعدادات — كل واحدة منها طلب PUT بصيغة form-urlencoded يأخذ معرّف الكتاب التفاعلي بوصفه معامل مسار (/api/set-…/{flipbookId}). يُبقي ذلك كل استدعاء صغيرًا وقابلًا للتنبؤ ضمن خط أنابيب دفعي.

خيارات التهيئة الشائعة

• الوصول بكلمة مرور — set-password-access لحماية كتاب تفاعلي خلف كلمة مرور
• العلامة التجارية — set-logo وset-background-image وset-skin وset-meta لبيانات SEO الوصفية وصورة المشاركة الاجتماعية
• التقاط العملاء المحتملين — set-lead-capture (إضافةً إلى set-lead-fields وset-lead-webhook وset-lead-google-sheets) لجمع معلومات المشاهد
• النطاق المخصص — انشر تحت نطاقك الخاص عبر نقاط نهاية CNAME (راجع إعداد CNAME)
• حالة النشر — set-published للنشر أو إلغاء النشر عند الطلب
• ضوابط المشاركة والعرض — set-share-channels وset-viewer-controls والمزيد

# Example: password-protect the flipbook you just created
curl -X PUT 'https://go.fliplink.me/api/set-password-access/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsPasswordProtected=true' \
  --data-urlencode 'Password=spring2026'

يُعيد كل استدعاء إعداد {"Result":"OK","Message":"Updated successfully"}. يُسهّل هذا الفصل بين الرفع والتهيئة تطبيق إعدادات مختلفة على كتب تفاعلية مختلفة ضمن سير العمل الدفعي نفسه. يسرد مرجع API كل نقطة نهاية set-* مع معاملاتها الدقيقة وكونسول "جرّبها" (Try-It) مباشر.

مسارات الإنشاء الدفعي

عندما تحتاج إلى تحويل مجلد كامل من ملفات PDF، يتولى سير العمل الدفعي العبء الثقيل. النمط مباشر:

1. افحص مجلد المصدر بحثًا عن ملفات PDF
2. ارفع كل ملف PDF إلى FlipLink API
3. اضبط الإعدادات وفق قواعد (مثل أنماط أسماء الملفات أو ملفات البيانات الوصفية)
4. سجّل عناوين URL الناتجة للكتب التفاعلية
5. أبلغ أصحاب المصلحة أو الأنظمة التابعة

إليك مثالًا مبسطًا بلغة Python:

import os
import requests

API_KEY = os.environ["FLIPLINK_API_KEY"]
PDF_DIR = "./catalogs"
BASE = "https://go.fliplink.me/api"
HEADERS = {"X-Api-Key": API_KEY}

results = []

for filename in os.listdir(PDF_DIR):
    if not filename.endswith(".pdf"):
        continue

    filepath = os.path.join(PDF_DIR, filename)
    title = filename.replace(".pdf", "").replace("-", " ").title()

    with open(filepath, "rb") as f:
        response = requests.post(
            f"{BASE}/create-by-file",
            headers=HEADERS,
            files={"File": (filename, f, "application/pdf")},
            data={"Name": title, "Title": title, "DocType": "Flipbook"},
        )

    data = response.json()
    if data.get("Result") == "OK":
        results.append({"title": title, "id": data["ID"], "url": data["URL"]})
        print(f"Created: {title} -> {data['URL']}")
    else:
        print(f"Failed: {title} -> {data.get('Message')}")

print(f"Batch complete: {len(results)} flipbooks created")

لاحظ معالجة الاستجابة: يُعيد FlipLink رمز HTTP 200 حتى لأخطاء التطبيق، لذا يتفرّع السكربت بناءً على حقل JSON Result لا على رمز الحالة. للدفعات الأكبر، أضف إعادة المحاولة للرفعات الفاشلة، واحترم حد المعدّل (300/دقيقة) بإدراج توقف قصير بين الطلبات.

استدعاءات Webhook للتحديثات اللحظية

بمجرد أن يصبح الكتاب التفاعلي مباشرًا، تتيح لك webhooks التفاعل مع نشاط المشاهدين في الوقت الفعلي بدلًا من الاستعلام المتكرّر. تضبط webhook لكل كتاب تفاعلي عبر PUT /api/set-lead-webhook/{flipbookId}، موجّهًا إيّاه إلى نقطة النهاية الخاصة بك. عندها يرسل FlipLink طلب POST إلى ذلك العنوان حين يلتقط الكتاب التفاعلي نشاطًا — أساسًا العملاء المحتملون الجدد، مع توفّر أحداث المشاهدة والبيع عبر إعدادات العملاء المحتملين والمبيعات ذات الصلة.

لربط ذلك برمجيًا:

# Send new-lead events for flipbook 90001 to your endpoint
curl -X PUT 'https://go.fliplink.me/api/set-lead-webhook/90001' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'WebhookURL_NewLead=https://example.com/hooks/fliplink'

يمكنك إطلاق تسليم تجريبي في أي وقت عبر POST /api/test-webhook/{flipbookId} للتأكد من أن معالجك يستقبل الحمولة قبل الانطلاق المباشر. تُمكّن webhooks خطوط الأنابيب اللحظية: عند وصول عميل محتمل جديد، يمكن لمعالجك أن يدفع جهة الاتصال إلى نظام CRM، أو يرسل إشعار Slack، أو يطلق حملة بريد إلكتروني. تفضّل العمل بلا كود؟ يمكن توجيه الأحداث نفسها عبر Zapier أو Make أو n8n. راجع مجموعة نقاط نهاية التقاط العملاء المحتملين في مرجع API للاطّلاع على خيارات الـ webhook وGoogle Sheets.

حالات استخدام واقعية

منصات النشر

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

تكاملات CMS

اربط FlipLink بنظام إدارة المحتوى لديك بحيث يؤدي رفع ملف PDF إلى مجلد أو نوع محتوى محدّد إلى إنشاء كتاب تفاعلي تلقائيًا. يُدرَج كود التضمين الناتج في الصفحة أو المنشور ذي الصلة. هذا قوي بشكل خاص لكتالوجات المنتجات وكتب الموضة ومواقع التوثيق.

توزيع التقارير الآلي

كثيرًا ما تتبع التقارير المالية والمراجعات الفصلية ومستندات الامتثال جدولًا متوقعًا. أتمت السير بالكامل: ولّد PDF من أداة التقارير الخاصة بك، وارفعه إلى FlipLink عبر API، وطبّق العلامة التجارية وضوابط الوصول الصحيحة، ووزّع رابط الكتاب التفاعلي على أصحاب المصلحة — كل ذلك مُطلَق بمهمة cron واحدة أو حدث سير عمل.

كتالوجات منتجات التجارة الإلكترونية

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

دمج وصول API مع تكاملات الأتمتة

الواجهة قوية بمفردها، لكنها تصبح أكثر مرونة عند إقرانها بـتكاملات الأتمتة. استخدم أدوات مثل Zapier وMake وn8n لربط FlipLink بمئات التطبيقات الأخرى دون كتابة كود. على سبيل المثال:

• Google Drive + FlipLink — أنشئ كتابًا تفاعليًا تلقائيًا عند ظهور PDF جديد في مجلد Drive محدّد
• Shopify + FlipLink — ولّد كتابًا تفاعليًا للمنتج كلما نُشرت مجموعة جديدة
• HubSpot + FlipLink — ألحق رابط كتاب تفاعلي بسجل جهة اتصال عندما يطلب كتيّبًا

للاطلاع بعمق أكبر على ربط FlipLink بأدوات خارجية، راجع دليلنا حول استخدام FlipLink API للتكاملات.

أفضل الممارسات لمسارات الكتب التفاعلية المدفوعة بـ API

• استخدم العمليات الفريدة (idempotent) — ضمّن معرّفًا مرجعيًا فريدًا مع كل رفع لتتمكن من إعادة المحاولة بأمان دون إنشاء تكرارات
• عالج الأخطاء بسلاسة — سجّل الإخفاقات، وطبّق إعادة المحاولة بتراجع أُسّي، ونبّه عند تكرار الأخطاء
• خزّن معرّفات الكتب التفاعلية — اربط كل PDF مصدر بمعرّفه ID في قاعدة بياناتك؛ فهو معامل المسار {flipbookId} لكل استدعاء قراءة وتحديث وحذف
• تفرّع بناءً على Result لا على رمز الحالة — تعود أخطاء التطبيق برمز HTTP 200 مع Result: "ERROR"؛ ولا تستخدم 401 إلا إخفاقات المصادقة
• راقب الاستخدام — تتبّع حجم استدعاءات API مقابل حد المعدّل 300/دقيقة، وراقب Flipbooks_Left في استجابات الإنشاء مقابل سعة منشوراتك النشطة

ابدأ الأتمتة اليوم

يُحوّل FlipLink API إنشاء الكتب التفاعلية من مهمة يدوية إلى سير عمل آلي قابل للتوسع. سواء كنت تعالج عشرة ملفات PDF أسبوعيًا أو عشرة آلاف، تتعامل الواجهة مع ذلك بجودة ثابتة ودون أي عبء يدوي.

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