صور الغلاف والمعاينة

العلامة التجارية والمحتوى

حدّد ملف PDF للمعاينة الذي يراه القرّاء قبل التقاط العملاء المحتملين أو الدفع، وملف PDF المكوَّن من صور فقط المُستخدَم للصور المصغّرة والمعاينات، عبر الـ API.

الواجهات المُستخدَمة في هذا النقاش

هل من خطأ أو معلومة قديمة في هذا الدليل؟

ما الذي يمكنك فعله

تتحكّم نقطتا نهاية للكتابة في ملفات PDF التي تنوب عن الكتيّب قبل أن يحصل القارئ على وصول كامل:

حدّد ملف PDF للمعاينة المعروض للقرّاء قبل التقاط العملاء المحتملين / الدفع.
حدّد ملف PDF المكوَّن من صور المُستخدَم للصور المصغّرة والمعاينات.

يستهدف كل استدعاء كتيّبًا واحدًا عبر {flipbookId} الخاص به ويُعيد نتيجة نجاح بسيطة.

قبل أن تبدأ

ستحتاج إلى:

مفتاح API — يُرسَل في ترويسة X-Api-Key، أو ضمن Authorization: Bearer YOUR_API_KEY، مع كل طلب.
الـ {flipbookId} — المُعرّف الرقمي للكتيّب/المستند، الذي يُعيده create-by-file / create-by-url (بوصفه ID) أو تُعيده list.
تذهب جميع الطلبات إلى الرابط الأساسي https://go.fliplink.me.

تأخذ نقطتا النهاية كلتاهما جسمًا بصيغة form-urlencoded (لا JSON).

حدّد ملف PDF للمعاينة

يحدّد PUT /api/set-preview-pdf/{flipbookId} ملف PDF للمعاينة المعروض للقرّاء قبل التقاط العملاء المحتملين / الدفع. ويُمسح تلقائيًا إذا كان كلٌّ من التقاط العملاء المحتملين ووضع البيع مُطفأً.

أرسِل رابط ملف PDF المراد استخدامه بوصفه PreviewPDF:

PreviewPDF — رابط ملف PDF المراد عرضه كمعاينة. تُخزَّن القيمة كما هي؛ ولا يتحقّق الـ API من أن الرابط قابل للوصول (مُختبَر حيًّا)، لذا أرسِل رابط PDF صالحًا وقابلًا للوصول. والافتراضي فارغ (لا ملف PDF للمعاينة).

curl -X PUT 'https://go.fliplink.me/api/set-preview-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'PreviewPDF=https://go.fliplink.me/files/preview.pdf'

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

حدّد ملف PDF للصور

يحدّد PUT /api/set-image-pdf/{flipbookId} ملف PDF المكوَّن من صور فقط / للمعاينة المُستخدَم للصور المصغّرة والمعاينات. أرسِل رابط ملف PDF المراد استخدامه بوصفه IMGPdf:

IMGPdf — الصورة المُستخدَمة للصور المصغّرة والمعاينات، تُرسَل بوصفها قيمة نصية (رابط صورة/PDF مُستضاف أو مُعرِّف data:)، لا رفعَ ملف. تُخزَّن القيمة كما هي؛ ولا يتحقّق الـ API من أن الرابط قابل للوصول (مُختبَر حيًّا)، لذا أرسِل رابطًا صالحًا وقابلًا للوصول. تحصل الكتيّبات الجديدة الآن على صورة مصغّرة حقيقية مولَّدة تلقائيًا عند الإنشاء (ويُعيد replace-pdf توليدها)؛ وإرسال قيمة فارغة يُبقي الصورة الحالية.

curl -X PUT 'https://go.fliplink.me/api/set-image-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IMGPdf=https://go.fliplink.me/files/pages.pdf'