Question 1

ما هو ClearLogo؟

Accepted Answer

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

Question 2

هل أحتاج إلى التسجيل لتجربة الواجهة البرمجية؟

Accepted Answer

لا. يمكنك إرسال طلبات مجهولة إلى https://api.clearlogo.dev/logo/{domain} على الفور للاختبار منخفض الحجم — لا يلزم مفتاح. للحركة المرورية الإنتاجية ستحتاج إلى مفتاح متصفح أو مفتاح خادم من لوحة التحكم.

Question 3

هل أحتاج إلى خادم خلفي لاستخدام ClearLogo؟

Accepted Answer

لا. يتيح لك مفتاح المتصفح تضمين عناوين URL للشعارات مباشرة في علامات <img> من كود الواجهة الأمامية. يتم التحقق من صحة الطلبات من خلال مطابقة Origin/Referer مقابل النطاقات المسموحة التي تقوم بتكوينها على المفتاح. استخدم مفتاح الخادم فقط عندما تفضل المصادقة Authorization: Bearer من خادمك الخلفي.

Question 4

من أين أبدأ؟

Accepted Answer

المسار الأسرع: افتح ساحة اللعب، وألصق بعض النطاقات الممثلة، وانظر كيف يبدو الناتج في واجهة المستخدم الخاصة بك. عندما تكون راضياً، أنشئ مفتاح إنتاجي في لوحة التحكم واستبدل عنوان URL في الكود الخاص بك.

Question 5

ما هي أفضل حالات الاستخدام لـ ClearLogo؟

Accepted Answer

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

Question 6

ما الفرق بين مفتاح المتصفح ومفتاح الخادم؟

Accepted Answer

مفتاح المتصفح (pk_…) آمن للشحن في كود الواجهة الأمامية وعلامات <img>. يتم المصادقة على الطلبات من خلال مطابقة رأس Origin أو Referer مقابل النطاقات المسموحة التي تقوم بتكوينها. مفتاح الخادم (sk_…) يقوم بالمصادقة عبر Authorization: Bearer YOUR_KEY من خادمك الخلفي ويجب عدم تعريضه أبداً للمتصفح.

Question 7

كيف أقيد مفتاح المتصفح الخاص بي إلى نطاقات معينة؟

Accepted Answer

في لوحة التحكم، افتح إعدادات المفتاح، وفعّل النطاقات المسموحة فقط، وأضف نطاقاتك واحداً في كل سطر. يتم دعم تدوين البطاقات البدية مثل *.example.com للنطاقات الفرعية.

Question 8

ماذا يحدث للطلبات بدون رأس Referer بعد تفعيل قيود النطاق؟

Accepted Answer

يتم حظرها. ستفشل حركة المرور المباشرة والطلبات المرسلة مع Referrer-Policy: no-referrer أو same-origin بمجرد تفعيل قيود النطاق. تتضمن السياسات التي تعمل strict-origin-when-cross-origin وorigin وorigin-when-cross-origin وunsafe-url. يمكنك التحقق من إعدادك بالتحقق من رأس Referer على طلبات img.logo.dev في علامة التبويب الشبكة بمتصفحك قبل تفعيل القيود.

Question 9

كيف أقوم بتدوير أو استبدال مفتاح الواجهة البرمجية؟

Accepted Answer

أنشئ مفتاحاً جديداً في لوحة التحكم، وحدّث التكامل الخاص بك لاستخدامه، ثم احذف المفتاح القديم. إذا كنت بحاجة إلى تدوير عاجل، فاتصل بـ support@clearlogo.dev.

Question 10

ما تنسيقات الصور التي ترجعها ClearLogo؟

Accepted Answer

png هو الافتراضي. يمكنك طلب webp أو jpeg عبر معامل الاستعلام format. عند حذف format، تقوم الواجهة البرمجية بالتفاوض على المحتوى من رأس الطلب Accept — تتلقى المتصفحات الحديثة التي تحمل عبر <img> WebP تلقائياً.

Question 11

ماذا تعني "دراية الخلفية"؟

Accepted Answer

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

Question 12

ما الأحجام المتاحة؟

Accepted Answer

يقبل معامل size قوى اثنين: 16، 32، 48، 64، 96، 128، 192، 256، 512، و1024 بكسل. الصورة دائماً مربعة. الافتراضي هو 128 بكسل. القيم خارج هذه القائمة يتم تقريبها تلقائياً إلى أقرب حجم مسموح به (عند التعادل يُختار الأكبر).

Question 13

ماذا يفعل معامل `theme`؟

Accepted Answer

يؤدي تعيين theme=dark إلى إرجاع متغير الخلفية الداكنة للشعار عند توفره. إذا لم يكن هناك متغير داكن، فإن الواجهة البرمجية تعود إلى الإصدار القياسي.

Question 14

ما هي حدود المعدل؟

Accepted Answer

تختلف الحدود حسب الخطة — راجع صفحة التسعير للتفاصيل. يتم إرجاع الاستخدام لكل مفتاح في رؤوس الاستجابة X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset حتى تتمكن من مراقبة الاستهلاك في الوقت الفعلي.

Question 15

ماذا يحدث عندما أتجاوز حد المعدل الخاص بي؟

Accepted Answer

ترجع الواجهة البرمجية HTTP 429 مع رأس Retry-After يشير إلى عدد الثواني التي يجب الانتظار قبل إعادة المحاولة. سنتصل بك قبل اتخاذ أي إجراء آخر — لا يتم قطع الخدمة بدون تحذير.

Question 16

كيف أتحقق من الاستخدام الحالي الخاص بي؟

Accepted Answer

الاستخدام في الوقت الفعلي مرئي في لوحة التحكم. يمكنك أيضاً قراءة رأس X-RateLimit-Remaining على أي استجابة API.

Question 17

الشعار لا يظهر لنطاق ما — ما الذي يجب أن أتحقق منه؟

Accepted Answer

تحقق من هذه قائمة التحقق: (1) تأكد من أن النطاق هو اسم مضيف بسيط بدون نظام أو مسار، مثل github.com وليس https://github.com/؛ (2) تحقق من أن مفتاح الواجهة البرمجية الخاص بك صالح وليس منتهي الصلاحية؛ (3) إذا كانت قيود النطاق مفعلة، تحقق من أن رأس Referer يتم إرساله؛ (4) تحقق من رمز حالة الاستجابة — 404 يعني عدم العثور على شعار لذلك النطاق، 401 يعني مشكلة مصادقة، 429 يعني محدود المعدل.

Question 18

الشعار الخاص بنطاق ما يبدو خاطئاً أو قديماً — ماذا يمكنني أن أفعل؟

Accepted Answer

اتصل بنا على support@clearlogo.dev مع اسم النطاق وملاحظة حول ما يبدو غير صحيح. سنراجعه ونحدّث الأصل.

Question 19

أحصل على خطأ 401 — ماذا يعني ذلك؟

Accepted Answer

401 يعني أن الطلب لم يتم المصادقة عليه. لمفاتيح المتصفح، تأكد من أن معامل الاستعلام token مضمن وأن رأس Origin/Referer يطابق نطاقاً مسموحاً. لمفاتيح الخادم، تأكد من أن رأس Authorization: Bearer YOUR_KEY موجود والمفتاح لم يتم حذفه.

Question 20

تحميل الشعارات في الإنتاج ولكن ليس أثناء التطوير المحلي — كيف أصلح ذلك؟

Accepted Answer

أضف localhost (أو localhost:3000 وlocalhost:5173 وغيرها) إلى النطاقات المسموحة للمفتاح الخاص بك في لوحة التحكم. تطابق الواجهة البرمجية مقابل الأصل الدقيق، لذا قم بتضمين المنفذ إذا كان خادم التطوير الخاص بك يستخدم واحداً غير قياسي. أزل الإدخالات المحلية قبل توزيع المفتاح، أو أنشئ مفتاح تطوير منفصل.

Question 21

أرى أخطاء CORS في المتصفح — كيف أصلح ذلك؟

Accepted Answer

تعيّن الواجهة البرمجية رؤوس CORS متسامحة، لذا تشير أخطاء CORS عادة إلى رأس Referer مفقود أو محظور بدلاً من مشكلة CORS حقيقية. تحقق من Referrer-Policy في صفحتك — السياسات مثل no-referrer تمنع إرسال رأس Referer، مما سيتسبب في فشل الطلبات عند تفعيل قيود النطاق. تحقق أيضاً من علامة <img> نفسها: سمة referrerpolicy="no-referrer" أو referrerpolicy="same-origin" على العنصر تتجاوز السياسة على مستوى الصفحة وتزيل Referer من هذا الطلب المحدد.

Question 22

ما الخطط المتاحة؟

Accepted Answer

توفر ClearLogo خطة مجانية للاستخدام منخفض الحجم وخطط مدفوعة للحركة المرورية الإنتاجية. راجع صفحة التسعير للحصول على تفاصيل الخطة الحالية وحدود الطلب.

Question 23

كيف أرقّي خطتي؟

Accepted Answer

قم بزيارة لوحة التحكم واختر الترقية من بطاقة الخطة الخاصة بك. ستتم إعادة توجيهك إلى صفحة الفواتير حيث يمكنك اختيار خطة وإكمال الدفع.

Question 24

هل يمكنني إلغاء الاشتراك؟

Accepted Answer

نعم. يمكنك الإلغاء في أي وقت من لوحة التحكم. تبقى الخطة الخاصة بك نشطة حتى نهاية فترة الفواتير الحالية.

المساعدة والأسئلة الشائعة

البدء السريع

مفاتيح الواجهة البرمجية والمصادقة

الناتج والتنسيق

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

استكشاف الأخطاء وإصلاحها

الفواتير والخطط

هل لا تزال لديك سؤال؟