API جاهزية الوكلاء للمواقع

API جاهزية الوكلاء

دقّق في كيفية إتاحة المواقع العامة لمسارات الاكتشاف والمحتوى المفيد وسياسة الوصول وقدرات الوكلاء. تُرجع API درجة موزونة من 0 إلى 100 ودرجات أربعة أبعاد وأدلة على مستوى الفحص وثقة وتسميات نضج وملاحظات وتوصيات.

{ "outcome": "complete", "summary": { "coverage": "multi_channel", "detected_signals": 2, "total_signals": 4 }, "signals": { "webmcp": { "status": "unknown", "validation": "runtime_required" }, "remote_mcp": { "status": "not_detected" }, "openapi": { "status": "detected", "validation": "confirmed" }, "llms_txt": { "status" ...

Category بيانات الويب

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

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

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

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

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

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم 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

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

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

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

معلمات الطلب

المعامل

urldomainskip_cache

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

مثال الرد

outcomesummarysummary.coveragesummary.detected_signalssummary.total_signalssignalssignals.webmcpsignals.webmcp.statussignals.webmcp.validationsignals.remote_mcpsignals.remote_mcp.statussignals.openapi

تغطية الحالة

رموز حالة HTTP

200400401402429502

نقاط النهاية

GET /v1/agent-readiness

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

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

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

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

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

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

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

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

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

نشط طلب مثال

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

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

أربعة أبعاد للجاهزية

قيّم قابلية الاكتشاف والمحتوى وسياسة الوصول والقدرات في استجابة واحدة.

تقييم وثقة شفافان

تحصل حالات النجاح على الرصيد الكامل، والتحذيرات على رصيد جزئي، والفشل على صفر. تُستبعد الفحوص غير المعروفة من الدرجة وتخفض الثقة.

الأدلة والملاحظات والنضج

راجع حالة كل فحص ووزنه وطريقته وأدلته وملاحظاته ومرجعه وتسميته المتعلقة بالنضج.

عمليات تدقيق مضبوطة وجاهزة للأتمتة

استخدم درجات وتوصيات متسقة في فحوص الإصدارات والمراقبة ومراجعات المحافظ وسير عمل الجودة الداخلي دون تنفيذ الأدوات المكتشفة.

طلب مثال

GET /v1/agent-readiness?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/agent-readiness

مثال الرد

200 OK json

{
  "outcome": "complete",
  "summary": {
    "coverage": "multi_channel",
    "detected_signals": 2,
    "total_signals": 4
  },
  "signals": {
    "webmcp": { "status": "unknown", "validation": "runtime_required" },
    "remote_mcp": { "status": "not_detected" },
    "openapi": { "status": "detected", "validation": "confirmed" },
    "llms_txt": { "status": "detected", "validation": "confirmed" }
  },
  "recommendations": [
    { "code": "ADD_WEBMCP_TOOLS", "severity": "low" }
  ]
}

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

ماذا تُرجع API؟

تُرجع درجة من 0 إلى 100 عند توفر فحوص حاسمة، ودرجات أربعة أبعاد، وأكثر من 35 فحصًا مضبوطًا، والثقة والأدلة والملاحظات وتسميات النضج والتوصيات.

كيف أفسّر الحالة «غير معروف»؟

يعني غير معروف أن الفحص لم يمكن حسمه من الأدلة المتاحة. يُستبعد من الدرجة ويخفض الثقة. لا تعتبره نجاحًا أو فشلًا.

هل تنفّذ API الأدوات المكتشفة؟

لا. يقيّم فحص الجاهزية إشارات الاكتشاف ولا يستدعي أدوات WebMCP أو أدوات التطبيق المكتشفة.

كيف تُحسب درجة جاهزية الوكلاء من 0 إلى 100؟

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

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

رموز حالة HTTP

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

OK 200

نجح الطلب

طلب غير صالح 400

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

غير مصرح 401

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

الدفع مطلوب 402

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

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

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

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

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

تحقّق من جاهزية الوكلاء

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