توليد صور بطاقات تويتر عبر واجهة برمجة التطبيقات (API)
صورة بطاقة تويتر (X) هي المعاينة الكبيرة التي تظهر عند مشاركة رابط على منصة X. تقوم FastOG بتوليدها ديناميكيًا بمقاس 1200×630 وترسل إشارة summary_large_image، بحيث تحصل كل صفحة على بطاقة X مناسبة دون الحاجة إلى إنشاء صورة يدويًا.
ما الذي تحتاجه صورة بطاقة تويتر
يقرأ X وسوم Open Graph ويعرض بطاقة summary_large_image عندما ترتبط الصفحة بـ twitter:card = summary_large_image. تُعرض الصورة بمقاس 1200×630. ينتج FastOG ذلك بالضبط، وتشير twitter:image إلى نفس الرابط الديناميكي مثل og:image.
كيفية ربط بطاقة تويتر الديناميكية
قم بإنشاء رابط FastOG الخاص بك مرة واحدة، ثم اضبط كل من وسوم OG وTwitter الوصفية على هذا الرابط.
<meta property="og:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="My Post">
<meta name="twitter:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
يعمل نفس الرابط لكلا الوسمين. يلجأ X إلى
og:imageإذا كانtwitter:imageغير موجود، لكن ضبط كلاهما أمر غير ضار وواضح.
نصائح حول مدقق بطاقة X
| الفحص | التفاصيل |
|---|---|
| الرابط العام | يجب أن تكون الصورة قابلة للجلب من قبل X دون مصادقة |
| حجم الملف / التنسيق | حافظ على الحجم أقل من 5 ميجابايت؛ PNG هو الأفضل لبطاقات النصوص |
| التخزين المؤقت | يخزّن X البيانات مؤقتًا بشكل مكثف — استخدم مدقق البطاقات لفرض تحديث |
| الروابط الموقّعة | روابط FastOG الموقّعة بالمحتوى تتحكم فقط في العرض الأول؛ تبقى البطاقات المخزّنة مؤقتًا صالحة |
الأسئلة الشائعة
هل أحتاج إلى صور منفصلة لـ X وOpen Graph؟
لا. يقرأ X نفس الصورة بمقاس 1200×630. هذه الصفحة موجودة لأن وسوم twitter:card الصحيحة قد يكون من السهل إخطاء فيها.
لماذا لا يتم تحديث بطاقة X الخاصة بي بعد تغيير العنوان؟
يخزن X البطاقة القديمة في ذاكرة التخزين المؤقت. افتح مدقق بطاقات X، والصق الرابط، ثم أعد فحص الصفحة.
هل يتولى FastOG معالجة وسوم twitter meta أيضًا؟
يولّد FastOG الصورة؛ بينما ما زلت بحاجة إلى إضافة وسوم twitter:card وtwitter:image إلى صفحتك (كما هو موضح أعلاه). أداة مولّد وسوم Open Graph المجانية تكتب جميع الوسوم نيابةً عنك.