ForHosting KIT · قراءة المواقع ومراقبتها

إنشاء وسم اكتشاف لخلاصات RSS وAtom وJSON Feed

اختر RSS وأدخل https://example.com/feed.xml?lang=en&source=site لتحصل على وسم اكتشاف بالنوع المطابق application/rss+xml، مع كتابة علامة & بأمان على شكل &. وتُرفض الصيغ غير المعروفة والعناوين التي ليست عناوين ويب. مجانية في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

نوع الموجز: Rss
عنوان الويب: https://example.com/feed.xml?lang=en&source=site

تحصل على

نوع MIME: application/rss+xml

يكون اكتشاف الخلاصات أكثر موثوقية عندما تشير الصفحة بوضوح إلى مورد النشر الموجّه للمتصفحات وقارئات الخلاصات وبرامج الزحف. تستقبل هذه الأداة نوع الخلاصة وعنوان URL مطلقاً، ثم تختار نوع الوسائط المناسب، وتهرّب المحارف التي قد تفسد سمة HTML، وتعيد عنصر link rel alternate كاملاً وجاهزاً لقسم head.

اختر التنسيق المطابق للمستند المنشور

لا يفيد وسم الاكتشاف إلا إذا كانت سمة type تصف المورد الموجود عند عنوان URL وصفاً صحيحاً. تربط الأداة هذه الخيارات بالأنواع application/rss+xml وapplication/atom+xml وapplication/feed+json على الترتيب. لا تفحص الأداة الوجهة ولا تنزّل محتواها، ولذلك يجب أن يطابق اختيارك ما يرسله الخادم فعلياً.

يساعد التصريح الدقيق قارئ الخلاصات على تحديد قدرته على معالجة المورد قبل جلبه أو تحليله. ترفض الأداة الأسماء غير المعروفة بدلاً من تخمينها، لأن النوع الذي يبدو معقولاً وهو خاطئ يجعل تشخيص مشكلة الاكتشاف أصعب. إذا كان موقعك يوفر أكثر من تنسيق، فشغّل الأداة لكل نقطة وصول وضع جميع العناصر الناتجة في head.

عندئذ يمثل كل وسم بديلاً حقيقياً يستطيع العميل المتوافق اختياره.

أدخل العنوان العام والأساسي للخلاصة

تُفضّل العناوين المطلقة في بيانات الاكتشاف لأن الصفحات المنسوخة والمستندات المخزنة مؤقتاً والعملاء الذين يعالجون العنوان الأساسي بطرق مختلفة سيصلون إلى نقطة الوصول نفسها. تزيل الأداة المسافات المحيطة، وتتحقق من إمكان تحليل القيمة كعنوان URL، وترفض المخططات مثل file وdata وjavascript. وتحافظ على عنوان الويب المقدم بدلاً من إعادة كتابة المسار أو الاستعلام أو الجزء أو صيغة الهروب أو حالة الأحرف دون إشعار.

تُرمّز المحارف ذات المعنى الخاص داخل سمة HTML في الوسم الناتج، فيصبح رمز العطف في الاستعلام آمناً من دون تغيير حقل url المعاد. يؤكد هذا التحقق الشكل والمخطط فقط، ولا يثبت الملكية أو التوافر أو نوع المحتوى أو عمليات إعادة التوجيه أو إعداد TLS. اختبر نقطة الوصول المنشورة بصورة مستقلة وتأكد من أنها تعيد الخلاصة المقصودة بنجاح.

وعند نقل الخلاصة، حدّث إعادة التوجيه وهذا الوسم معاً.

ضع العنصر الناتج وتحقق منه

انسخ الوسم المعاد إلى قسم head في صفحة HTML التي تريد إتاحة اكتشاف خلاصتها. يُحذف title عمداً لأن المدخلات لا تتضمن سوى التنسيق والعنوان؛ فاختلاق وصف أقل فائدة من ترك اختيار اللغة والصياغة المناسبة لك داخل قالب الموقع. إذا كان الموقع يضم خلاصات متعددة، مثل خلاصة رئيسية وخلاصات للموضوعات، فأنشئ عنصراً لكل عنوان وأضف عناوين واضحة في تطبيقك عندما يحتاج المستخدمون إلى التمييز بينها.

راجع المصدر الذي يصل فعلياً بعد النشر، فقد يغيّر محرك القوالب أو مستوى الحماية الوسم حتى لو كانت القيمة المولدة صحيحة. ثم جرّب الاكتشاف بواسطة قارئ خلاصات واحد على الأقل وافحص ترويسات استجابة نقطة الوصول.

حالات الاستخدام

إضافة اكتشاف RSS إلى موقع نشر

أنشئ عنصر head لنقطة RSS في مدونة أو موقع أخبار من دون الحاجة إلى حفظ نوع الوسائط.

الإعلان عن بديل بتنسيق Atom

أنشئ وسماً متسقاً لاكتشاف خلاصة Atom المقدمة إلى جانب تنسيقات نشر أخرى.

الأسئلة الشائعة

ما أنواع الخلاصات المدعومة؟

القيم المقبولة هي rss وatom وjson-feed. تؤدي أي قيمة أخرى إلى خطأ إدخال غير صالح.

هل تتحقق الأداة من وجود الخلاصة؟

لا. تتحقق من المدخلات وتبني الوسم من دون إجراء أي طلب شبكي.

هل تُعالج المحارف الخاصة في العنوان بأمان؟

نعم. تُهرّب المحارف ذات المعنى الخاص في سمات HTML داخل الوسم، بينما يحتفظ حقل url المنفصل بالمدخل بعد إزالة المسافات المحيطة.

موقعي يقدّم RSS وAtom معًا، فكم وسمًا أحتاج؟

وسمًا لكل خلاصة. شغّل المولد مرة لكل صيغة وضع كل الوسوم الناتجة في قسم head من الصفحة، حتى يختار كل قارئ النسخة التي يفهمها.

ماذا أغيّر عند نقل خلاصتي إلى عنوان جديد؟

حدّث إعادة التوجيه على الخادم وهذا الوسم معًا، حتى يبدأ المشتركون الجدد بالعنوان الحالي مباشرة بدل الاعتماد الدائم على إعادة التوجيه.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/web/link-rel-alternate-build

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/web/link-rel-alternate-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"feed_type":"rss","url":"https://example.com/feed.xml"}'

const res = await fetch("https://api.kit.forhosting.com/web/link-rel-alternate-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "feed_type": "rss",
    "url": "https://example.com/feed.xml"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/link-rel-alternate-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "feed_type": "rss",
    "url": "https://example.com/feed.xml"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/link-rel-alternate-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"feed_type":"rss","url":"https://example.com/feed.xml"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"feed_type":"rss","url":"https://example.com/feed.xml"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/link-rel-alternate-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "feed_type": "rss",
  "url": "https://example.com/feed.xml"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.link_rel_alternate_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

وهي تدعم RSS وAtom وJSON Feed، وترفض التنسيقات غير المعروفة وعناوين URL غير الصالحة أو غير المخصصة للويب.

اختر التنسيق المطابق للمستند المنشور

اختر rss لمستند RSS بتنسيق XML، أو atom لمستند Atom بتنسيق XML، أو json-feed لمستند JSON Feed. كما يمنع أخطاء النسخ الشائعة، مثل الإعلان عن نقطة Atom بنوع RSS أو عرض JSON Feed على أنه JSON عام.

أدخل العنوان العام والأساسي للخلاصة

أدخل عنوان URL مطلقاً ببروتوكول HTTP أو HTTPS يمكن لقارئ الخلاصات لدى الزائر الوصول إليه، مثل https://example.com/feed.xml.

ضع العنصر الناتج وتحقق منه

تستخدم النتيجة rel="alternate" ونوع الوسائط الخاص بالتنسيق وعنوان الخلاصة المهرّب في href. تشغّل أداة المتصفح وAPI الدالة الحتمية نفسها، لذلك تنتج المدخلات المتطابقة الحقول والوسم نفسيهما. يمكن لعمليات البناء الآلية استدعاء API مقابل $0.002 لكل طلب، بينما يجري الاستخدام التفاعلي محلياً داخل المتصفح.

حالات التكامل

نشر بيانات JSON Feed الوصفية

استخدم نوع الوسائط المسجل لـ JSON Feed داخل عنصر alternate ذي هروب صحيح.

أسئلة تقنية

ما تكلفة طلب API؟

تكلفة كل طلب API هي $0.002. تعمل نسخة المتصفح محلياً مجاناً.

لماذا يجب أن يكون عنوان URL مطلقاً؟

يبقى عنوان HTTP أو HTTPS المطلق واضحاً لقارئات الخلاصات بصرف النظر عن الصفحة أو العنوان الأساسي الذي اكتشفته منه.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

اختر التنسيق المطابق للمستند المنشور

أدخل العنوان العام والأساسي للخلاصة

ضع العنصر الناتج وتحقق منه

حالات الاستخدام

إضافة اكتشاف RSS إلى موقع نشر

الإعلان عن بديل بتنسيق Atom

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

اختر التنسيق المطابق للمستند المنشور

أدخل العنوان العام والأساسي للخلاصة

ضع العنصر الناتج وتحقق منه

حالات التكامل

نشر بيانات JSON Feed الوصفية

أسئلة تقنية

شكرًا