واجهة API لشعار الشركة وأصول هوية الموقع

واجهة API لـ أصول هوية الموقع

أرسل نطاقاً وتلقَّ أصول الهوية المستندة إلى المصدر والمكتشفة من موقعه العام. يتضمن كل مرشح مصدر اكتشافه، بينما تبقى الأصول غير الموجودة بقيمة null.

{ "domain": "example.com", "organization_name": "Example", "assets": { "logo_url": "https://example.com/logo.svg", "favicon_url": "https://example.com/favicon.ico", "theme_color": "#111827", "candidates": [] }, "confidence": 0.8, "evidence": ["organization_name", "structured_logo", "declared_icon"] }

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

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

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

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

يستخدمه أشخاص في شركات مميزة

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

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

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

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

OpenAPI ملفات API

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

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

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

10,000 حصة مجانية

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عدة المطور

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

مخطط OpenAPI

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

مجموعة Postman

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

SDKs وCLI

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

تكامل MCP

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

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

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

معلمات الطلب

المعامل

domainskip_cachedomains

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

مثال الرد

domainorganization_nameassetsassets.logo_urlassets.favicon_urlassets.theme_colorassets.candidatesconfidenceevidence

تغطية الحالة

رموز حالة HTTP

200400401402429502

نقاط النهاية

GET /v1/identity-assets

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

POST /v1/identity-assets/bulk

الرصيد: 2/itemالمصادقة: المصادقة مطلوبة

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

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

حالة الخدمة ملفات API

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

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

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

حصة مجانية اشترك مجاناً

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

نشط طلب مثال

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

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

اكتشاف الشعار المستند إلى المصدر

اعثر على مرشحي الشعارات المعلنين عبر البيانات المنظّمة وبيانات الموقع العامة.

الأيقونات المفضلة وأيقونات التطبيقات

استخرج الأيقونات المفضلة وأيقونات Apple touch وأيقونات القناع ومراجع بيان الويب.

أصول المعاينة والسمة

أرجع صور معاينة Open Graph وألوان السمة المعلنة إلى جانب أصول الهوية.

مصدر الأصل

يحدد كل مرشح مصدره ونوع الأصل ونوع MIME وحجمه المعلن عند توفره.

الملفات الاجتماعية المعلنة

أدرج الملفات العامة الموحّدة التي يربط بها الموقع، مع المصدر ومستوى الثقة.

البحث المجمع عن أصول العلامة

عالج حتى 10 نطاقات في طلب واحد مع نتائج مرتبة وأخطاء لكل عنصر.

طلب مثال

GET /v1/identity-assets?domain=example.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-assets?domain=example.com"

POST /v1/identity-assets/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"domains":["example.com","github.com"]}' https://domscan.net/v1/identity-assets/bulk

مثال الرد

200 OK json

{
  "domain": "example.com",
  "organization_name": "Example",
  "assets": {
    "logo_url": "https://example.com/logo.svg",
    "favicon_url": "https://example.com/favicon.ico",
    "theme_color": "#111827",
    "candidates": []
  },
  "confidence": 0.8,
  "evidence": ["organization_name", "structured_logo", "declared_icon"]
}

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

كيف يختار DomScan شعار الشركة؟

يمنح DomScan الأولوية للشعارات المعلنة صراحةً في البيانات المنظّمة من نوع Organization، ويحتفظ بأيقونات الموقع الأخرى وصور المعاينة كمرشحين منفصلين.

ما الفرق بين الشعار والأيقونة المفضلة؟

يمثل الشعار المؤسسة، بينما الأيقونة المفضلة هي أيقونة صغيرة للموقع. وتعرضهما API بشكل منفصل حتى يختار تطبيقك الأصل المناسب.

هل تستضيف API الصور المعادة أو تغيّرها؟

لا. تعيد API عناوين URL العامة الأصلية للأصول ومصدرها. ويبقى تطبيقك مسؤولاً عن الاستخدام المسموح والتخزين المؤقت والعرض.

ماذا يحدث عندما لا يملك الموقع شعاراً صالحاً للاستخدام؟

تبقى قيمة حقل الشعار null. ويمكن أن تظهر الأيقونات أو صور المعاينة المعلنة الأخرى كمرشحين منفصلين من دون تصنيفها خطأً كشعارات.

هل يمكنني جلب شعارات الشركات بشكل مجمع؟

نعم. أرسل ما يصل إلى 10 نطاقات إلى نقطة النهاية المجمعة. وتحافظ النتائج على ترتيب الإدخال، ولا تخفي الإخفاقات الفردية العناصر الناجحة.

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

رموز حالة HTTP

نوثّق رموز حالة HTTP التي يجب على عميلك التعامل معها حتى تتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات غير الموجودة وأعطال الخدمة الخارجية.

OK 200

نجح الطلب

طلب غير صالح 400

معلمات غير صالحة

غير مصرح 401

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

الدفع مطلوب 402

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

طلبات كثيرة جداً 429

تم تجاوز حد المعدل

بوابة غير صالحة 502

خطأ RDAP من المصدر upstream

أنشئ باستخدام بيانات هوية الموقع

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