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

إنشاء وسوم Open Graph للمشاركة على الشبكات الاجتماعية

يحوّل مولّد وسوم Open Graph هذا أربعة حقول أساسية للمشاركة إلى كتلة HTML سليمة توضع في رأس الصفحة.

● Betaمجاني · داخل متصفحك

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

أدخل العنوان والوصف ورابط الصورة ونوع الكائن، فتحصل على الترميز الكامل وعلى كل وسم في سطر مستقل. تتحقق الأداة من استخدام الصورة لبروتوكول HTTP أو HTTPS، وتحذف المسافات الخارجية، وتهرّب المحارف التي قد تفسد سمة HTML. النتيجة حتمية وجاهزة للقوالب وأنظمة النشر، كما تتوفر عبر API بتكلفة $0.002 لكل طلب.

اختر محتوى يصف الصفحة المشتركة بدقة

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

قدّم صورة عامة على الويب واختر النوع الصحيح

يجب أن يكون رابط الصورة عنواناً مطلقاً يستخدم مخطط http أو https. تُرفض المسارات النسبية والملفات المحلية وروابط البيانات وعناوين FTP والروابط غير الصالحة، لأن برامج زحف الشبكات الاجتماعية تحتاج إلى الوصول إلى المورد عبر الويب. يثبت الفحص صحة التنسيق والبروتوكول فقط؛ فهو لا ينزّل الصورة ولا يقيس أبعادها ولا يفحص نوع الوسائط ولا يضمن قدرة زاحف خارجي على الوصول إليها. استخدم رابط إنتاج ثابتاً بدلاً من عنوان معاينة مؤقت، وتأكد من أن المصادقة أو قواعد برامج الزحف أو الحماية من الربط المباشر لا تحجب خدمات إنشاء البطاقات. تتحول خانة النوع إلى قيمة og:type. يُستخدم website عادة للصفحة العامة وarticle للمحتوى التحريري. ويقبل المولّد أي نوع غير فارغ حتى يدعم القيم ذات نطاق الاسم وامتدادات Open Graph المتوافقة.

ثبّت الوسوم وافحص النتيجة المنشورة

تتضمن الاستجابة حقل html وفيه أربعة عناصر meta تفصل بينها أسطر جديدة، ومصفوفة tags التي تضم العناصر نفسها منفردة. ضعها داخل رأس المستند بواسطة نظام بيانات المسارات أو قالب الخادم أو مرحلة البناء الثابت المسؤولة عن الصفحة. يبقى الترتيب ثابتاً: العنوان ثم الوصف ثم الصورة ثم النوع. تُهرّب علامة العطف والأقواس الزاوية وعلامات الاقتباس والفواصل العليا كي لا تكسر القيم بنية الترميز. لا تهرّب الناتج مرة أخرى عند إدراجه في قالب HTML، وإلا فقد تظهر كيانات نصية بدلاً من الوسوم الفعالة. بعد النشر، افحص المصدر الذي يرسله الخادم فعلياً، وتأكد من وجود قيمة معتمدة واحدة لكل خاصية؛ فقد تضيف القوالب والمكونات الإضافية وإعدادات أطر العمل وسوماً منافسة. وأخيراً، اختبر الرابط بأدوات تصحيح المشاركة للمنصات المهمة. يزود الترميز الصالح برامج الزحف بمدخلات واضحة، لكن كل منصة تتحكم في القص والاختصار والتخزين المؤقت والعرض النهائي.

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

نشر مقال

حوّل العنوان والملخص والصورة الرئيسية والنوع المعتمدة إلى كتلة بيانات اجتماعية جاهزة للإدراج.

إنشاء صفحات المنتجات

أنشئ ترميز Open Graph متسقاً من سجلات المنتجات المنظمة أثناء البناء الثابت أو العرض على الخادم.

توحيد مخرجات نظام إدارة المحتوى

وفّر للمحررين منسقاً حتمياً يتحقق من بروتوكول الصورة ويهرّب كل قيمة بأمان.

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

ما الوسوم التي تُنشأ؟

تحتوي النتيجة على عناصر meta المسماة og:title وog:description وog:image وog:type.

لماذا رُفض رابط صورتي؟

يجب أن يكون للصورة رابط مطلق صالح بمخطط http أو https؛ وتُرفض المسارات النسبية والمخططات الأخرى.

هل يتحقق المولّد من وجود الصورة؟

لا. لا يجري أي طلب شبكي، ولذلك يتحقق من التنسيق والبروتوكول فقط، لا من التوفر أو الأبعاد أو وصول برامج الزحف.

هل يمكن استخدام نوع Open Graph غير website أو article؟

نعم. يُقبل أي نوع غير فارغ ضمن الحد المعلن، بما في ذلك قيم امتدادات Open Graph المتوافقة.

ما تكلفة API؟

تبلغ تكلفة API مقدار $0.002 لكل طلب. وتتوفر نسخة المتصفح مجاناً في هذه الصفحة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/open-graph-generate

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

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

curl -X POST https://api.kit.forhosting.com/web/open-graph-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"A Practical Guide to Urban Gardening","description":"Learn how to grow herbs and vegetables in a small city space.","image_url":"https://example.com/images/urban-garden.jpg","type":"article"}'

const res = await fetch("https://api.kit.forhosting.com/web/open-graph-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "title": "A Practical Guide to Urban Gardening",
    "description": "Learn how to grow herbs and vegetables in a small city space.",
    "image_url": "https://example.com/images/urban-garden.jpg",
    "type": "article"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/open-graph-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "title": "A Practical Guide to Urban Gardening",
    "description": "Learn how to grow herbs and vegetables in a small city space.",
    "image_url": "https://example.com/images/urban-garden.jpg",
    "type": "article"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/open-graph-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"title":"A Practical Guide to Urban Gardening","description":"Learn how to grow herbs and vegetables in a small city space.","image_url":"https://example.com/images/urban-garden.jpg","type":"article"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"title":"A Practical Guide to Urban Gardening","description":"Learn how to grow herbs and vegetables in a small city space.","image_url":"https://example.com/images/urban-garden.jpg","type":"article"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/open-graph-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "title": "A Practical Guide to Urban Gardening",
  "description": "Learn how to grow herbs and vegetables in a small city space.",
  "image_url": "https://example.com/images/urban-garden.jpg",
  "type": "article"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.open_graph_generate",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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