FlipLink CLI أم API أم MCP: أي تكامل يناسبك؟

يمنحك FlipLink ثلاث طرق لأتمتة الكتيّبات دون لمس لوحة التحكم: أداة سطر أوامر، وREST API، وخادم MCP للمساعدين الذكيين. قد تبدو كأنها ثلاثة منتجات مختلفة، لكنها ليست كذلك. إنها ثلاثة أبواب تؤدي إلى المحرّك نفسه — النقاط الطرفية نفسها، والبيانات نفسها، والحساب نفسه.

لذا فالسؤال الحقيقي ليس “أيها الأفضل؟”، بل “أيها يناسب ما تعمل عليه الآن؟” يقدّم لك هذا الدليل مقارنة محايدة وقاعدة سريعة لـ“اختر واحدًا”.

ثلاثة أبواب وAPI واحد

كل ما يمكن لـ FlipLink فعله برمجيًا يمرّ عبر REST API واحد على https://go.fliplink.me، مع المصادقة بترويسة X-Api-Key. أما CLI وخادم MCP فكلاهما مبنيّ مباشرة فوق الـAPI نفسه — بل إن قائمة أوامر CLI وقائمة أدوات MCP تُولّدان من مواصفات النقاط الطرفية نفسها، فلا يمكن أن تتباعدا.

ولهذا نتيجة مفيدة: ما يمكنك فعله في واحدة منها، يمكنك فعله في الثلاث جميعًا. الفرق يكمن في مَن يقود وكم من الكود تريد كتابته — لا في القدرة نفسها.

مصفوفة القرار

تشترك الثلاث جميعًا في نموذج الاستجابة نفسه: كل ردّ هو JSON مع حقل Result في المستوى الأعلى بقيمة "OK" أو "ERROR"، والحدّ نفسه للطلبات وهو 300 طلب في الدقيقة لكل مفتاح.

متى تلجأ إلى كلٍّ منها

CLI — للسكربتات والطرفيات وCI/CD

استخدم CLI حين تعيش داخل طرفية أو خط أنابيب. إنه أسرع طريق من “لديّ ملف PDF” إلى “لديّ كتيّب منشور” دون كتابة عميل HTTP. ضعه داخل سكربت shell أو مهمة cron أو خطوة في GitHub Actions، وتحصل على أتمتة قابلة للتكرار. أضف --json إلى أي أمر ومرّره إلى jq للسكربتات. اطّلع على البدء مع CLI.

API — للتطبيقات

استخدم API حين يكون FlipLink ميزة داخل شيء تبنيه — بوابة عملاء تنشئ كتيّبات عند التسجيل، أو لوحة تحكم تسحب بيانات التقاط العملاء المحتملين، أو مزامنة مع CRM. تحصل على تحكم كامل ويمكنك استدعاؤه من أي لغة تتحدث HTTP. يضمّ مرجع API كل نقطة طرفية مع وحدة تجريب “Try-It” حيّة.

MCP — للمساعدين الذكيين وغير المطوّرين

استخدم خادم MCP حين لا يُفترض بالشخص (أو الوكيل) الذي يؤدي العمل أن يعرف بوجود نقطة طرفية أصلًا. اربط FlipLink بـ Claude أو Cursor أو أي عميل MCP آخر، وعندها يمكنك أن تقول “انشر عرض الربع الثالث وأعطني رابط المشاركة” بلغة بسيطة. يختار المساعد الأداة المناسبة ويملأ المعاملات. إنه الخيار الأقل احتكاكًا لغير المبرمجين — ويأتي مع ضوابط أمان تجعل الإجراءات المدمّرة بحاجة إلى تأكيد أولًا.

🚀

جرّب FlipLink مجاناً

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

Drop your PDF here or click to browse

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

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

يمكنك المزج بينها

ليست هذه الخيارات حصرية يستبعد بعضها بعضًا. ثمة إعداد شائع يستخدم الثلاثة معًا: الـ API يشغّل تطبيق الإنتاج، وCLI يشغّل مهام الدُّفعات الليلية في CI، وخادم MCP يتيح لفريقك إنشاء كتيّبات لمرة واحدة بمجرد سؤال مساعد ذكي. الحساب نفسه، والكتيّبات نفسها، والبيانات نفسها — مجرد أبواب مختلفة للحظات مختلفة.

المهمة نفسها بثلاث طرق

إليك النتيجة نفسها بالضبط — إنشاء كتيّب من ملف PDF — عبر كل باب.

CLI — أمر واحد في طرفيتك:

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

API — طلب HTTP تُرسله من الكود:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@q3-report.pdf' \
  -F 'Name=q3' \
  -F 'Title=Q3 Report'

MCP — لغة طبيعية في عميلك الذكي:

“أنشئ كتيّبًا من q3-report.pdf بعنوان ‘Q3 Report’.”

خلف الكواليس يستدعي المساعد أداة flipbook_create_by_file بالمعاملات نفسها التي في طلب curl أعلاه. وتُعيد الثلاث جميعًا الـ JSON نفسه — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — لأن الثلاث تصل إلى النقطة الطرفية نفسها.

دليل سريع لـ“اختر واحدًا”

• تكتب سكربتًا أو خط أنابيب CI/CD؟ → CLI
• تبني الكتيّبات داخل تطبيقك الخاص؟ → API
• تريد مساعدًا ذكيًا أو شخصًا غير مبرمج أن يقوم بذلك؟ → MCP
• لست متأكدًا؟ ابدأ بـ CLI — إنه أسرع طريقة لرؤية النتائج، وما تتعلّمه ينطبق مباشرة على API.

أيًّا كان الباب الذي تدخل منه، فأنت تستخدم محرّك FlipLink نفسه. اختر ما يناسب أسلوب عملك اليوم — ويمكنك دائمًا إضافة آخر لاحقًا.

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

• البدء مع FlipLink CLI
• اربط FlipLink بـ Claude عبر خادم MCP
• ما هو خادم MCP؟
• كيف تستخدم FlipLink API للتكاملات المخصصة
• الأتمتة والتكاملات
• الوصول إلى API