البدء مع واجهة سطر الأوامر FlipLink CLI

إن كنت تقضي وقتك في الطرفية (terminal)، فإن التنقل عبر لوحة التحكم لنشر كتاب متحرك يبدو وكأنه التفاف عن الطريق. تتيح لك أداة FlipLink CLI إنجاز العملية كاملةً — الإنشاء والنشر والمشاركة — دون مغادرة الصدفة (shell). فهي غلاف رفيع قابل للبرمجة فوق واجهة FlipLink API، أي أن كل ما يمكنك فعله عبر طلب HTTP يمكنك إنجازه بأمر واحد.

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

تثبيت الأداة

تأتي الأداة على هيئة حزمة npm وتحتاج إلى Node.js الإصدار 18 أو أحدث. ثبّتها بشكل عام (global) ليكون أمر fliplink متاحاً في كل مكان:

npm install -g fliplink-cli

تفضّل ألا تثبّت أي شيء بشكل دائم؟ يمكنك تشغيل أي أمر عند الطلب باستخدام npx:

npx fliplink-cli whoami

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

ضبط مفتاح API الخاص بك

كل أمر يتحقق من هويتك عبر مفتاح FlipLink API الخاص بك. احصل على مفتاح بتسجيل الدخول على https://go.fliplink.me وفتح صفحة الاشتراك.

خزّن المفتاح مرة واحدة وتتذكّره الأداة:

fliplink config set-key YOUR_API_KEY

يكتب هذا المفتاح إلى ~/.config/fliplink/config.json بصلاحيات 600، بحيث لا يستطيع قراءته سوى مستخدمك أنت. أما في حالات CI/CD أو السكربتات حيث تفضّل ألا تكتب ملف إعدادات، فاضبط متغيّر بيئة بدلاً من ذلك:

export FLIPLINK_API_KEY=YOUR_API_KEY

تحدّد الأداة بيانات الاعتماد بهذا الترتيب: متغيّر البيئة FLIPLINK_API_KEY أولاً، ثم ملف الإعدادات. تعامل مع المفتاح كأنه كلمة مرور — لا تُدرجه أبداً في مستودع. وإن أردت خلفية أعمق عن آلية عمل هذا النوع من المصادقة المعتمدة على الترويسة (header)، فإن مدخل API في المسرد مرجع تمهيدي جيد.

تأكيد اتصالك

قبل أي شيء آخر، أجرِ فحصاً سريعاً للحالة. يستدعي الأمر whoami نقطة نهاية هوية الحساب ويؤكد أن مفتاحك يعمل:

fliplink whoami

تطبع الاستجابة الناجحة تفاصيل حسابك (وأقصى حجم رفع متاح لك). وإن ظهر لك خطأ في المصادقة، فهذا يعني أن مفتاحك مفقود أو خاطئ — أعد تشغيل config set-key وحاول مجدداً. هذا هو الاستدعاء الأول نفسه الذي نوصي به لواجهة API ذاتها، لذا فهو اختبار تحقق موثوق.

إنشاء كتاب متحرك من ملف PDF

والآن إلى الجزء الممتع. وجّه الأداة إلى ملف PDF محلي وأعطه عنواناً:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

ما يراه القرّاء هو --title، أما --name فهو تسمية داخلية تستخدمها لاحقاً للعثور عليه. يرفع الأمر الملف، ويبدأ عملية التحويل، ويُرجع معرّف الكتاب المتحرك الجديد. دوّن هذا المعرّف — ستحتاجه في الخطوتين التاليتين.

ملف PDF مستضاف لديك مسبقاً في مكان ما؟ تجاوز خطوة الرفع وأنشئ من رابط بدلاً من ذلك:

fliplink flipbook create-url https://example.com/deck.pdf --title "Q3 Report"

🚀

جرّب FlipLink مجاناً

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

Drop your PDF here or click to browse

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

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

النشر والمشاركة

لا يصبح الكتاب المتحرك المُنشأ حديثاً عاماً حتى تنشره. وإليك التسلسل الكامل — الإنشاء ثم النشر ثم جلب رابط المشاركة — باستخدام المعرّف المُرجَع في كل خطوة:

# 1. Create from a PDF and note the returned ID
fliplink flipbook create ./deck.pdf --title "Q3 Report" --name q3

# 2. Publish it (use the ID from step 1)
fliplink flipbook publish 90001

# 3. Get the public share link
fliplink flipbook share-link 90001

يحوّل publish الكتاب المتحرك إلى حالة مباشرة، ويُرجع share-link الرابط الذي تسلّمه للقرّاء. غيّرت رأيك؟ الأمر fliplink flipbook unpublish 90001 يُعيده إلى وضع غير مباشر دون حذف أي شيء.

مخرجات قابلة للقراءة الآلية باستخدام --json

تطبع الأداة افتراضياً مخرجات سهلة القراءة للبشر. أضف --json إلى أي أمر للحصول على استجابة JSON الخام بدلاً من ذلك — مثالية للتمرير إلى jq أو لالتقاط قيمة داخل سكربت:

fliplink flipbook create ./deck.pdf --title "Q3 Report" --json | jq -r '.ID'

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

رموز الخروج للبرمجة النصية

تستخدم الأداة رموز خروج متوقعة لتتمكن سكربتاتك من التفرّع وفق النجاح أو الفشل دون تحليل المخرجات:

هذا الفصل مهم: الرمز 2 يعني أن طلبك وصل إلى FlipLink لكنه رُفض لسبب متعلق بالعمل (مدخلات غير صالحة، تجاوز الحصة)، بينما الرمز 1 يعني أن الطلب نفسه فشل. وفي سكربت الصدفة يمكنك التصرّف وفقاً لذلك:

fliplink flipbook publish 90001 || echo "Publish failed with exit code $?"

إلى أين تتجه بعد ذلك

أصبحت لديك الآن الحلقة الأساسية: التثبيت والمصادقة والإنشاء والنشر والمشاركة. ومن هنا يمكنك ربط الأداة بأي شيء يشغّل أوامر.

• مرجع الأوامر الكامل — كل علامة وأمر فرعي موجود في توثيق CLI.
• أتمتها — شغّل التسلسل نفسه وفق جدول زمني أو مع كل إيداع (commit). يشرح دليلنا حول أتمتة نشر الكتب المتحركة في CI/CD خطوات خط أنابيب حقيقي.
• تحتاج قوة API الخام؟ — تغلّف الأداة مرجع API، وتصل المنفذ الخلفي fliplink api إلى أي نقطة نهاية لا تغطّيها الأوامر المسمّاة بعد.

ما إن تنشر أول كتاب متحرك لك من الطرفية حتى تبدأ لوحة التحكم تبدو اختيارية — وهذا هو المقصود بالضبط.

قراءات ذات صلة

• توثيق FlipLink CLI — مرجع الأوامر الكامل
• CLI أم API أم MCP: أيها ينبغي أن تستخدم؟
• أتمتة نشر الكتب المتحركة في CI/CD
• كيفية استخدام FlipLink API للتكاملات المخصّصة
• الأتمتة والتكاملات
• ما هي واجهة API؟ (المسرد)