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

واجهة API لـ واجهة برمجة البحث عن الصور الشخصية والشعارات

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

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

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

GET /v1/avatar

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

مثال الرد 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

طلب مثال GET /v1/avatar

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

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

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

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

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

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

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

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

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

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

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

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

OpenAPI ملفات API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عدة المطور

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

مخطط OpenAPI

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

مجموعة Postman

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

SDKs وCLI

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

تكامل MCP

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

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

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

معلمات الطلب

المعامل

emailusernameplatformdomain

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

مثال الرد

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

تغطية الحالة

رموز حالة HTTP

200400401402429

نقاط النهاية

GET /v1/avatar

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

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

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

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

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

OpenAPI ملفات API

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

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

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

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

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

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

تتم مطابقة عناوين البريد الإلكتروني مع خدمات الصور الشخصية العامة وشعار الشركة صاحبة نطاق البريد. تُفحص أسماء المستخدمين على GitHub وBluesky وMastodon وKeybase. وتعيد النطاقات شعار الموقع.

صور موثّقة فقط

تُنزَّل كل صورة تُعاد ويُتحقق من أنها صورة حقيقية. لا تُعاد أبداً صفحات الخطأ أو الروابط المعطلة أو الصور الافتراضية البديلة.

أدلة لكل مصدر

يبلّغ كل مصدر بالحالة present أو absent أو unknown مع السبب، فلا يُخلط أبداً بين غياب الصورة ومصدر لم يستجب.

نتائج حديثة عند الحاجة

تُعاد الاستفادة من النتائج لبضع ساعات. أرسل max_age لتحديد أقصى عمر مسموح به للإجابة المخزّنة، أو max_age=0 لإجراء فحص جديد.

طلب مثال

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

مثال الرد

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

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

ما المصادر التي تُفحص؟

للبريد الإلكتروني: Gravatar وLibravatar وشعار BIMI لنطاق بريد الشركة. لاسم المستخدم: GitHub وBluesky وMastodon وKeybase، أو المنصة التي تختارها فقط. للنطاق: الشعار أو الأيقونة التي ينشرها الموقع وشعار BIMI الخاص به.

ماذا تعني absent؟

أجاب كل مصدر بوضوح أنه لا يملك صورة: لا يوجد حساب، أو حساب بلا صورة، أو لا يوجد شعار منشور. إذا كان أي مصدر محظوراً أو بطيئاً أو غير واضح، تكون النتيجة unknown بدلاً من ذلك.

لماذا قد تُوسم صورة GitHub بأنها قد تكون مولَّدة؟

يمنح GitHub الحسابات التي لم ترفع صورة نمطاً مولَّداً، ولا يوضح نوع الصورة لدى كل حساب. لا تُعاد هذه الصورة أبداً بوصفها الصورة الشخصية. تُدرج مع المصادر الأخرى وتوسم بعلامة، وإذا كانت الصورة الوحيدة التي عُثر عليها فالنتيجة unknown.

كم تبلغ تكلفتها بالرصيد؟

رصيدان لكل عملية بحث، مهما كان عدد المصادر المفحوصة. تُسترد تكلفة النتائج unknown.

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

رموز حالة HTTP

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

OK 200

نجح الطلب

طلب غير صالح 400

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

غير مصرح 401

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

الدفع مطلوب 402

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

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

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

ابحث عن صورة شخصية

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