الهوية والتحقق

واجهة API لـ واجهة صور الشعارات

اعرض شعار الشركة بجوار كل نطاق في منتجك. اطلب /v1/logo/ متبوعًا بالنطاق لتحصل على صورة PNG مربعة بالحجم المناسب وجاهزة لوسم img، مع ترويسات توضّح مصدرها. يمكنك تخزين الصور مؤقتًا وحفظها وتقديمها من خوادمك أو من شبكة CDN الخاصة بك.

عرض الوثائق استكشف جميع واجهات API

نقاط النهاية نشط

GET /v1/logo/:domain

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"

مثال الرد 200 OK

HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999

طلب مثال GET /v1/logo/stripe.com

الميزات الرئيسية 4

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

رموز حالة HTTP 401 / 402

Category الهوية والتحقق

نقاط النهاية 1

الميزات الرئيسية 4

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

يستخدمه أشخاص في هذه الشركات

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

1,000 أرصدة مجانية

ابدأ مع 1,000 رصيد مجاني كل شهر. تحتاج إلى المزيد؟ اختر خطة شهرية أو اشترِ باقة لمرة واحدة.

ما الذي تساعدك هذه الواجهة على إطلاقه

استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.

سير عمل المنتج

ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.

أتمتة المحللين

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

بيانات JSON نظيفة

استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.

أدوات الذكاء الاصطناعي والعمليات

زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.

سير عمل التكامل

مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.

المصادقة مرة واحدة

أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.

الاستعلام باستخدام الأمثلة

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

التشغيل والمراقبة

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

عدة المطور

انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.

مخطط OpenAPI

أنشئ عملاء أو افحص شكل كل طلب واستجابة.

مجموعة Postman

استورد طلبات جاهزة للاختبار اليدوي وتسليم الفريق.

SDKs وCLI

استخدم حزمًا مصانة وسير عمل سطر الأوامر بدل كتابة boilerplate.

تكامل MCP

اعرض ذكاء النطاقات لوكلاء الذكاء الاصطناعي وسير عمل المساعدين الداخليين.

خريطة المعلمات والاستجابة

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

معلمات الطلب

المعامل

domain

حقول الاستجابة

مثال الرد

successdatameta

تغطية الحالة

رموز حالة HTTP

401402

نقاط النهاية

GET /v1/logo/:domain

الرصيد: 1المصادقة: المصادقة مطلوبة

domain

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

1,000 أرصدة مجانية

ابدأ مع 1,000 رصيد مجاني كل شهر. تحتاج إلى المزيد؟ اختر خطة شهرية أو اشترِ باقة لمرة واحدة.

الميزات الرئيسية

شعار حقيقي أو إجابة صادقة

تأتي الشعارات مما تنشره الشركة نفسها: شعار البريد BIMI وأيقونات التطبيقات وأيقونات اللمس وشعارات البيانات المنظمة وأيقونات المواقع favicon. تُنزَّل كل صورة وتُفك ترميزاتها قبل إعادتها. وعندما لا يوجد شعار تحصل على الخطأ 404، أو على صورة حرف مُنشأة عند استخدام fallback=monogram، وتكون دائمًا موسومة بأنها مُنشأة.

بالحجم المناسب لواجهتك

اختر أي حجم من 16 إلى 512 بكسل، وretina لكثافة مضاعفة، وgreyscale، وtheme=light أو theme=dark لوضع الشعارات منخفضة التباين على بلاطة تبقى واضحة على خلفيتك. الصور مربعة بهوامش شفافة.

لك أن تخزّنها وتحتفظ بها

تحمل الاستجابات ترويسات تخزين مؤقت عام طويلة الأمد، وETag وLast-Modified. يمكن للمتصفحات وشبكة CDN الاحتفاظ بها، ويمكنك حفظ الملفات وتقديمها من خوادمك. أضف v= إلى عنوان URL لجعله ثابتًا لا يتغير.

آمنة للاستخدام في صفحة ويب

استخدم مفتاحًا قابلًا للنشر في المعامل token ولن يعمل إلا من المواقع التي تحددها، مع حدود لكل مفتاح ولكل زائر. أما المفاتيح السرية فتبقى على خادمك في ترويسة X-API-Key.

طلب مثال

GET /v1/logo/stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"

html

<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">

مثال الرد

200 OK json

HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999

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

كم رصيدًا يكلف الشعار؟

رصيد واحد لكل طلب، بما في ذلك الشعارات المقدّمة من التخزين المؤقت وصور الحروف المُنشأة والنطاقات التي لا شعار لها واستجابات 304 Not Modified. أما الطلبات المرفوضة قبل أي معالجة، مثل نطاق غير صالح أو مفتاح مستخدم من موقع غير مسموح به، فلا تُحتسب. خزّن الصورة مؤقتًا بدلًا من جلبها عند كل عرض للصفحة.

هل يمكنني حفظ الشعارات على خوادمي؟

نعم. يمكنك تخزين الصور المعادة مؤقتًا وحفظها وتقديمها من خوادمك أو من شبكة CDN الخاصة بك. تظل الشعارات علامات تجارية لأصحابها، لذا استخدمها للدلالة على الشركة التي تنتمي إليها.

ما الفرق بين غير موجود وغير متاح؟

غير موجود يعني أن الموقع وسجلات بريده استجابت ولا تنشر أي شعار صالح للاستخدام؛ وتُعاد هذه الإجابة لمدة ساعة. أما غير متاح فيعني أن الموقع حجب الطلب أو كان بطيئًا أو غير واضح الاستجابة، فلم يُستخلص أي استنتاج ويمكنك المحاولة مجددًا بعد بضع دقائق. تميّز الترويسة X-Logo-Status بين الحالتين.

كيف أعرف مصدر الشعار؟

تحدد X-Logo-Source المصدر، مثل bimi أو manifest_icon أو touch_icon أو favicon، وتشير X-Logo-Verification إلى أن الصورة فُكّ ترميزها. وتحمل صورة الحرف المُنشأة دائمًا X-Logo-Source: generated ولا تُعرض أبدًا على أنها شعار.

الأدوات والموارد ذات الصلة

رموز حالة HTTP

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

غير مصرح 401

مفتاح API أو الجلسة مفقود أو غير صالح.

الدفع مطلوب 402

لا توجد أرصدة كافية لتنفيذ هذا الطلب.

احصل على شعار

ابدأ مجاناً عرض الوثائق