قم بإنشاء صور Open Graph ذات العلامة التجارية للمشاركة الاجتماعية. قم بتمرير عنوان ووصف اختياري، واختر سمة فاتحة أو داكنة، وقم بتعيين لون مميز، وقم بتضمين عنوان URL لشعارك. تقوم واجهة برمجة التطبيقات (API) بإرجاع صورة PNG جاهزة للاستخدام يمكنك استخدامها كعلامة تعريف og:image.
Code examples
curl -X POST https://api.botoi.com/v1/og/generate \
-H "Content-Type: application/json" \
-d '{"title":"Ship faster with the Botoi API","description":"150+ developer endpoints, zero infrastructure to manage.","theme":"dark","color":"#3b82f6","logo":"https://botoi.com/logo.png"}'
When to use this API
معاينات منشورات المدونة الديناميكية
قم بإنشاء صورة OG فريدة لكل منشور مدونة في وقت النشر. قم بتمرير عنوان المنشور ومقتطفه إلى واجهة برمجة التطبيقات (API)، وقم بتخزين ملف PNG الناتج مؤقتًا على CDN الخاص بك، وستحصل كل مشاركة على وسائل التواصل الاجتماعي على معاينة للعلامة التجارية دون الحاجة إلى عمل تصميم يدوي.
بطاقات مشاركة لوحة المعلومات SaaS
عندما يشارك المستخدمون تقريرًا أو رابط لوحة المعلومات، أنشئ صورة OG بشكل سريع تتضمن عنوان التقرير وإحصائيات ملخصة. يرى المستلمون معاينة غنية بدلاً من خيار احتياطي عام.
بطاقات منتجات التجارة الإلكترونية
قم بإنشاء صور معاينة اجتماعية لصفحات المنتج عن طريق تمرير اسم المنتج وسعره ولون العلامة التجارية. يعرض كل رابط منتج تتم مشاركته على Twitter أو Slack أو LinkedIn بطاقة مصقولة.
Frequently asked questions
ما الأبعاد التي تستخدمها صورة OG التي تم إنشاؤها؟
تُرجع واجهة برمجة التطبيقات ملف PNG بحجم 1200 × 630، وهو الحجم الموصى به لصور Open Graph وTwitter Card. يتم عرض هذا القرار جيدًا عبر Facebook وLinkedIn وTwitter وSlack وDiscord.
هل يمكنني استخدام خط مخصص؟
تأتي واجهة برمجة التطبيقات (API) بخط sans-serif نظيفًا مُحسّنًا لسهولة القراءة في أحجام معاينة الوسائط الاجتماعية. تحميلات الخطوط المخصصة غير مدعومة في الوقت الحالي.
كيف يمكنني أن أخدم هذا كعلامة og:image الخاصة بي؟
يمكنك إما استدعاء واجهة برمجة التطبيقات (API) في وقت الإنشاء، وحفظ ملف PNG على CDN الخاص بك، والإشارة إلى عنوان URL هذا في العلامة الوصفية الخاصة بك؛ أو قم بتوجيه عنوان URL لـ og:image مباشرةً إلى نقطة نهاية واجهة برمجة التطبيقات (API) إذا كنت تفضل الإنشاء عند الطلب.
هل تم تخزين الاستجابة مؤقتًا؟
لا تقوم واجهة برمجة التطبيقات بتخزين الاستجابات مؤقتًا. إذا قمت بإرسال نفس المعلمات مرتين، فسيتم إنشاء صورة جديدة في كل مرة. لاستخدام الإنتاج، قم بتخزين النتيجة على CDN الخاص بك أو تخزين الكائنات.
ماذا يحدث إذا حذفت الوصف؟
يتم عرض الصورة مع العنوان فقط، في المنتصف عموديًا. يعمل هذا بشكل جيد مع العناوين القصيرة والمثيرة.
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.