استبدال ملف PDF الكتيّب ونسخه

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

تتيح لك نقاط النهاية هذه تغيير ملف PDF خلف كتيّب سبق أن أنشأته، أو إنشاء نسخ منه — كل ذلك على جانب الخادم، دون إعادة بناء أي شيء من الصفر:

• استبدل ملف PDF من ملف — ارفع ملف PDF جديدًا عبر multipart form data.
• استبدل ملف PDF من رابط — أعطِ الخادم رابطًا فيتولّى تنزيل ملف PDF الجديد.
• انسخ كتيّبًا — أنشئ نسخة أو أكثر، لكل منها ID جديد ورابط مشاركة URL خاص بها.

تحتفظ طريقتا الاستبدال بـ ID الكتيّب وإعداداته ورابط مشاركته — يتغيّر ملف PDF خلفه فقط.

قبل أن تبدأ

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

استبدل ملف PDF من ملف

رفع multipart. يعيد الخادم دمج ملف PDF الجديد تلقائيًا مع أي صفحة أمامية/خلفية لا تزال مرفقة بالكتيّب. ويحتفظ الكتيّب بـ ID وإعداداته ورابط مشاركته.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@/path/to/file'

الاستجابة:

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

استبدل ملف PDF من رابط

يستبدل ملف PDF لكتيّب موجود بملف يتولّى الخادم تنزيله من رابط تقدّمه. ويحتفظ الكتيّب بـ ID وإعداداته ورابط مشاركته.

curl -X PUT 'https://go.fliplink.me/api/replace-pdf-by-url/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'File=https://example.com/new.pdf'

الاستجابة:

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

انسخ كتيّبًا

يُنشئ نسخة أو أكثر من كتيّب على جانب الخادم — تحصل كل نسخة على ID جديد ورابط مشاركة URL خاص بها. يقبل Count القيم من 1 إلى 500 ويُقيَّد على جانب الخادم.

curl -X POST 'https://go.fliplink.me/api/duplicate/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'Count=3'

الاستجابة:

{
  "Result": "OK",
  "Count": 3,
  "Items": [
    {
      "ID": "93213",
      "URL": "https://go.fliplink.me/C73371B4-B041-4EBD-A518-1E5B5B56DA44"
    },
    {
      "ID": "93214",
      "URL": "https://go.fliplink.me/2F9A0C7D-6E51-4B22-A9F0-7D3C1E8B4A15"
    },
    {
      "ID": "93215",
      "URL": "https://go.fliplink.me/8B4E2A19-C037-45D6-9E1B-4A6F0D2C7E83"
    }
  ]
}

الأخطاء المحتملة

استبدال PDF (بالملف) — PUT /api/replace-pdf/{flipbookId}:

• مفتاح API مفقود أو غير صالح ← HTTP 401. يُعيد صفحة HTML لعدم التصريح 401 — دون أي جسم JSON.
• مُعرّف العنصر غير موجود أو غير مملوك لمفتاحك ← HTTP 200 مع Message: "Item not found".
• الملف المرفوع ليس PDF قابلًا للقراءة ← HTTP 200 مع Message: "File is not a valid PDF.".
• تجاوز الرفع الحد الأقصى لحجم الملف في الباقة ← HTTP 413 مع Message: "File exceeds the maximum allowed upload size.".

استبدال PDF (بالرابط) — PUT /api/replace-pdf-by-url/{flipbookId}:

• مفتاح API مفقود أو غير صالح ← HTTP 401. يُعيد صفحة HTML لعدم التصريح 401 — دون أي جسم JSON.
• مُعرّف العنصر غير موجود أو غير مملوك لمفتاحك ← HTTP 200 مع Message: "Item not found".
• حقل مجهول أو مكتوب خطأً في الجسم ← HTTP 200 مع Message: "Unknown field(s) '…'. Expected: …".

النسخ — POST /api/duplicate/{flipbookId}:

• مفتاح API مفقود أو غير صالح ← HTTP 401. يُعيد صفحة HTML لعدم التصريح 401 — دون أي جسم JSON.
• مُعرّف العنصر غير موجود أو غير مملوك لمفتاحك ← HTTP 200 مع Message: "Item not found".
• حقل مجهول أو مكتوب خطأً في الجسم ← HTTP 200 مع Message: "Unknown field(s) '…'. Expected: …".