الويب الحديث (واجهة API للمحتوى وwebhook)
انشر على أي موقع لا يعمل على WordPress: اجلب المقالات بمفتاح API (PULL)، أو استقبل كل مقال على الـ webhook الخاص بك (PUSH).
«تكامل الويب الحديث» مخصص لأي موقع لا يعمل على WordPress: موقع مبني خصيصًا، أو CMS بدون واجهة، أو موقع ثابت. هناك طريقتان، ويمكنك استخدام أيّ منهما. في طريقة السحب (PULL)، يجلب موقعك المقالات من Rankfender بمفتاح API. وفي طريقة الدفع (PUSH)، يرسل Rankfender كل مقال إلى Webhook الخاص بك عند نشره. وهو متاح في كل الخطط.
افتحه بزر «ربط» (أو «تهيئة») على البطاقة في «الإعدادات ← التكاملات». تضم النافذة تبويبين: «سحب (API)» و«دفع (Webhook)».
السحب (PULL): موقعك يجلب المقالات
انقر على «إنشاء مفتاح API»
يظهر المفتاح مع زر «نسخ»، ومعه التنبيه: «احفظ هذا المفتاح بأمان. في بيئة الإنتاج، استخدم متغيرات البيئة والعرض من جهة الخادم.»
انقر على «اختبار الاتصال»
تؤكد العبارة «تم الاتصال بنجاح! مفتاح API صالح ويعمل.» صلاحية المفتاح.
انسخ مثالًا
استخدم استدعاء API المباشر (curl) المعروض على البطاقة: يعمل كما هو مكتوب ويرسل المفتاح في الترويسة X-Rankfender-Key. أما أمثلة Next.js وReact وiframe على البطاقة فتعتمد على حزمة SDK وسكربت تضمين غير منشورين، لذا استدعِ API مباشرة من إطار العمل الذي تستخدمه.
المعاملات والاستجابات: مرجع واجهة API للمحتوى و المصادقة.
الدفع (PUSH): Rankfender يرسل كل مقال
| الحقل | ما تُدخله |
|---|---|
| «رابط Webhook» | «نقطة النهاية التي سيرسل إليها Rankfender بيانات المقال عبر POST»، مثل https://your-website.com/api/rankfender/publish. |
| «طريقة المصادقة» | بدون، أو مفتاح API (ترويسة X-API-Key)، أو Bearer Token، أو Basic Auth، أو سرّ Webhook (ترويسة X-Webhook-Secret). |
| بيانات المصادقة | المفتاح أو الرمز أو السرّ الخاص بتلك الطريقة. يُخفى أثناء الكتابة. |
| «ترويسات مخصّصة (اختياري)» | «ترويسات HTTP إضافية بصيغة JSON»، مثل {"X-Custom-Header": "value"}. |
| «تفعيل Webhook» | «عند التفعيل، تُرسل المقالات إلى Webhook عند نشرها». |
انقر على «حفظ الإعدادات»، ثم على «اختبار Webhook»: يرسل Rankfender مقالًا تجريبيًا بعنوان «Rankfender Webhook Test» مع الترويسة X-Rankfender-Test: true. ينجح الاختبار مع أي استجابة 2xx. وبعد عمليات الإرسال الفعلية، يعرض «آخر استدعاء ناجح:» التاريخ.
ما الذي تستقبله نقطة النهاية لديك
- طلب POST بجسم JSON والترويستين X-Rankfender-Event: article.published وX-Rankfender-Domain.
- المقال: title وslug وcontent (HTML) وexcerpt وmeta_description وmeta_title وkeywords وfeatured_image وauthor وpublished_at، إضافة إلى seo_data وcustom_data.
- يجب أن تُجيب نقطة النهاية برمز بين 200 و299. ويمكنها أن تُرجع {"url": "..."} مع عنوان الصفحة المنشورة.
- لا يخزّن Rankfender أي شيء لديك: احفظ البيانات في قاعدة بياناتك أو CMS الخاص بك.
القائمة الكاملة للحقول والترويسات: Webhooks.
ملاحظة
تحديد المقالات التي تُنشر وموعد نشرها يتم في المحتوى: النشر والطيار الآلي.