البدء السريع

ClearLogo هي واجهة برمجة تطبيقات HTTP تُرجع صورة شعار نظيفة بنسبة مناسبة على خلفية معتمة تتناسب مع الخلفية (بيضاء للوضع الفاتح، ومحايدة داكنة للوضع الداكن) لأي مجال عبر طلب GET واحد. لا يلزم تسجيل الدخول لحركة المرور المنخفضة الحجم؛ تستخدم حركة الإنتاج مفتاح المتصفح أو مفتاح الخادم.

1. جرب بدون مفتاح

نقطة النهاية مفتوحة لحركة التصفح منخفضة الحجم. أضف مجالاً وستحصل على PNG فورًا.

GET https://api.clearlogo.dev/logo/github.com?size=128&frame=fill&padding=10

أو أضفه مباشرة في HTML:

<img src="https://api.clearlogo.dev/logo/github.com?size=64&frame=fill&padding=10" alt="GitHub" />

2. احصل على مفتاح للإنتاج

أنشئ واحدًا من لوحة التحكم. اختر وضعًا بناءً على المكان الذي سيتم فيه تنفيذ الطلب:

• مفتاح المتصفح — أضفه مباشرة في علامات <img>. يتم التحقق من الاستدعاءات مقابل المجالات المسموح بها في المفتاح.
• مفتاح الخادم — أرسله كـ Authorization: Bearer …. احتفظ به في الخلفية — لا تُرسله أبدًا إلى متصفح.

قم بتسجيل الدخول لإنشاء مفتاح

3. اضبط النتيجة

عدة معاملات تتحكم في معظم النتائج: size (الحجم)، frame (fill يملأ اللوحة، original يحافظ على إطار الأيقونة المصدر)، padding (الهامش من كل جانب)، shape (square أو circle)، و theme (المتغير الفاتح أو الداكن، الذي يضبط أيضاً لون الخلفية المعتمة). افتح أداة التجربة لمعاينة المجموعات قبل نسخ الرابط النهائي.

الخطوات التالية

• أداة التجربة — جرب كل خيار مباشرة وانسخ الرابط الدقيق الذي ستستخدمه.
• احصل على مفتاح API — قم بتسجيل الدخول وأنشئ مفتاحًا عامًا أو سريًا لحركة الإنتاج.
• مرجع API — اطلع على نقطة النهاية والمعاملات وطرق المصادقة وسلوك تحديد المعدل.