التحكّم في فهرسة محركات البحث (noindex)

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

لكل كتيّب مُستضاف صفحة يمكن لمحركات البحث الزحف إليها. وتتيح لك نقطة النهاية هذه التحكّم فيما إذا كانت تلك الصفحة قابلة للفهرسة:

• أضِف إشارة noindex ليُبقي محركات البحث الكتيّب خارج نتائجها.
• أزِلها مجدّدًا ليصبح الكتيّب قابلًا للفهرسة كالمعتاد.

قبل أن تبدأ

ستحتاج إلى:

• مفتاح API — يُرسَل في ترويسة X-Api-Key مع كل طلب.
• الـ flipbookId — المُعرّف الرقمي المُعاد عند إنشاء كتيّب (بوصفه ID) أو من نقاط نهاية السرد.
• تذهب الطلبات إلى الرابط الأساسي https://go.fliplink.me.

يكون الجسم بصيغة form-urlencoded (لا JSON).

المعطى

يأخذ PUT /api/set-indexing/{flipbookId} حقل urlencoded واحدًا:

اجعل كتيّبًا غير قابل للفهرسة

اضبط IsNoIndex=true. لن تُدرِج محركات البحث التي تحترم إشارة robots صفحة الكتيّب.

curl -X PUT 'https://go.fliplink.me/api/set-indexing/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsNoIndex=true'

الاستجابة:

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

اسمح بالفهرسة مجدّدًا

اضبط IsNoIndex=false لإزالة إشارة noindex كي يتمكّن الكتيّب من الظهور في نتائج البحث.

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

الاستجابة:

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

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

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

ملاحظات

• noindex أداة SEO، لا أداة تحكّم في الوصول. فهي تطلب من محركات البحث ألّا تُدرِج الصفحة — لكنها لا تمنع من يملك الرابط من فتح الكتيّب. ولتقييد من يستطيع العرض، استخدم حماية كلمة المرور أو قائمة سماح بالبريد الإلكتروني.
• تغييرات الفهرسة ليست فورية. فحتى بعد ضبط noindex، على محرك البحث أن يعيد الزحف إلى الصفحة قبل أن تسقط من النتائج؛ والتوقيت متروك للمحرك.