FluxRSS
توثيق API

واجهة API الخاصة بـ FluxRSS

أنشئ flux RSS واعرضها واحذفها عبر طلب HTTP. API من نوع REST، استجابات JSON.

الأساس

جميع مسارات API مسبوقة بـ:

https://www.flux-rss.com/api/v1

المصادقة

تتم مصادقة API عبر مفتاح Bearer. أنشئ مفتاح frx_live_… في الإعدادات ← مفاتيح API (مضمّن ضمن عرض Mega). يُعرَض المفتاح مرة واحدة فقط — احتفظ به بعناية.

Authorization: Bearer frx_live_xxxxxxxxxxxxxxxxxxxx

نقاط النهاية

GET/api/v1/feeds
يعرض جميع flux الخاصة بك.
curl https://www.flux-rss.com/api/v1/feeds \
  -H "Authorization: Bearer frx_live_…"
الاستجابة:
{
  "data": [
    {
      "id": "cmqw50zts0006…",
      "title": "Faits divers",
      "sourceUrl": "https://www.ladepeche.fr/faits-divers/",
      "source": "native",
      "itemCount": 50,
      "feedUrl": "https://www.flux-rss.com/feeds/cmqw50zts0006….xml",
      "jsonUrl": "https://www.flux-rss.com/feeds/cmqw50zts0006….json",
      "createdAt": "2026-06-27T09:08:32.460Z"
    }
  ]
}
POST/api/v1/feeds
يُنشئ flux من عنوان URL مصدر. يخضع لحصّة عرضك.
curl -X POST https://www.flux-rss.com/api/v1/feeds \
  -H "Authorization: Bearer frx_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.lemonde.fr/faits-divers/"}'
الاستجابة 201:
{
  "id": "cmq…",
  "title": "Faits divers",
  "source": "native",
  "itemCount": 50,
  "feedUrl": "https://www.flux-rss.com/feeds/cmq….xml",
  "jsonUrl": "https://www.flux-rss.com/feeds/cmq….json"
}
GET/api/v1/feeds/:id
تفاصيل flux مع مقالاته.
curl https://www.flux-rss.com/api/v1/feeds/cmq… \
  -H "Authorization: Bearer frx_live_…"
DELETE/api/v1/feeds/:id
يحذف flux.
curl -X DELETE https://www.flux-rss.com/api/v1/feeds/cmq… \
  -H "Authorization: Bearer frx_live_…"

استهلاك flux (عمومي، دون مفتاح)

بمجرد توليده، يُقدَّم الـ flux على عنوان URL مستقر وعمومي، قابل للقراءة من أي قارئ RSS أو نصّ برمجي أو n8n أو Zapier…

# RSS 2.0
GET https://www.flux-rss.com/feeds/<id>.xml

# JSON Feed 1.1 (avec en-tête CORS)
GET https://www.flux-rss.com/feeds/<id>.json

# Limiter le nombre d'articles
GET https://www.flux-rss.com/feeds/<id>.json?limit=10

الحدود والأخطاء

الوصول إلى API (مفاتيح frx_live_) مضمّن ضمن عرض Mega. هل تحتاج إلى مساعدة؟ تواصل معنا.