مرجع واجهة API للمحتوى

واجهة API للمحتوى للقراءة فقط. تُرجع بصيغة JSON المقالات المنشورة للمشروع الذي يملك مفتاح API الخاص بك، ليعرضها موقعك على صفحاته.

نقطة النهاية

GET https://api.rankfender.com/functions/v1/public-article-api

عنوان واحد للطلبين كليهما. أرسل مفتاحك في الترويسة X-Rankfender-Key (راجع مفتاح API الخاص بك). لا تُرجع إلا المقالات ذات الحالة «منشور».

اسرد مقالاتك

دون id، تُرجع واجهة API صفحة من المقالات، الأحدث أولًا.

curl "https://api.rankfender.com/functions/v1/public-article-api?limit=10&offset=0" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "articles": [
    {
      "id": "8c1f…",
      "title": "…",
      "description": "…",
      "language": "en",
      "published_at": "2026-10-14T09:12:00Z",
      "updated_at": "2026-10-14T09:30:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "count": 1, "total": 1, "has_more": false }
}

تعطي القائمة لكل مقال المعرّف id والعنوان والوصف واللغة والتواريخ، دون المحتوى. خذ id من هنا لجلب مقال واحد.

اجلب مقالًا واحدًا

مع id، تُرجع واجهة API ذلك المقال مع محتواه الكامل بصيغة HTML.

curl "https://api.rankfender.com/functions/v1/public-article-api?id=ARTICLE_ID" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "article": {
    "id": "8c1f…",
    "title": "…",
    "content": "<h2>…</h2><p>…</p>",
    "description": "…",
    "language": "en",
    "published_at": "2026-10-14T09:12:00Z",
    "updated_at": "2026-10-14T09:30:00Z"
  }
}

الحقول

الأخطاء

مثال بلغة JavaScript

استدعِ واجهة API من شيفرة تعمل على الخادم، حتى لا يصل المفتاح أبدًا إلى متصفحات الزوار.

// Server-side code (Node 18+, Next.js server component, etc.)
const res = await fetch(
  "https://api.rankfender.com/functions/v1/public-article-api?limit=10",
  { headers: { "X-Rankfender-Key": process.env.RANKFENDER_KEY } }
);
const { articles, pagination } = await res.json();