أدوات المشاركة والقنوات

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

تتحكّم نقطتا نهاية في كيفية ظهور أزرار مشاركة الكتيّب في العارض:

• المفتاح الرئيسي — فعّل مجموعة أزرار المشاركة بأكملها أو ألغِها باستدعاء واحد.
• بدّالات لكل قناة — قرّر بدقّة أي القنوات الاجتماعية (Facebook وX وLinkedIn وWhatsApp والبريد الإلكتروني وغيرها) تظهر في قائمة المشاركة بالعارض.

كلتاهما تنطبقان على كتيّب واحد، يُحدَّد بـ {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). وكل قيمة حقل هي boolean تُرسَل كنص (true / false).

فعّل أزرار المشاركة أو ألغِها

الاستدعاء PUT /api/set-share-master/{flipbookId} هو المفتاح الرئيسي لتشغيل/إطفاء أزرار المشاركة في العارض.

curl -X PUT 'https://go.fliplink.me/api/set-share-master/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareButtons=false'

الاستجابة:

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

بدّل قنوات المشاركة كلًّا على حِدة

يبدّل PUT /api/set-share-channels/{flipbookId} كل قناة مشاركة اجتماعية (Facebook وX وLinkedIn وWhatsApp والبريد الإلكتروني وغيرها) كلًّا على حِدة في قائمة المشاركة بالعارض. أرسِل true لإظهار قناة أو false لإخفائها.

curl -X PUT 'https://go.fliplink.me/api/set-share-channels/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsShareFacebook=true' \
  --data-urlencode 'IsShareTwitter=true' \
  --data-urlencode 'IsShareWhatsApp=true' \
  --data-urlencode 'IsShareTelegram=false' \
  --data-urlencode 'IsShareLinkedIn=true' \
  --data-urlencode 'IsSharePinterest=false' \
  --data-urlencode 'IsShareReddit=false' \
  --data-urlencode 'IsShareTumblr=false' \
  --data-urlencode 'IsShareMessenger=false' \
  --data-urlencode 'IsShareEmail=true' \
  --data-urlencode 'IsShareLine=false' \
  --data-urlencode 'IsShareWeChat=false' \
  --data-urlencode 'IsShareInstagram=false' \
  --data-urlencode 'IsShareFlipboard=false' \
  --data-urlencode 'IsShareGeneral=true'

الاستجابة:

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

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

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