API Catalog
يُدرج API catalog واجهات API لديك ويشير إلى وصف كل واحدة ومستنداتها ونقطة حالة تشغيلها، بصيغة linkset وفق RFC 9727.
لماذا يهم
هكذا يعرف وكيل لم يرَ منتجك من قبل أن لديك واجهة API أصلًا، دون قراءة موقعك التسويقي.
معيار النجاح
يعيد /.well-known/api-catalog النوع application/linkset+json مع مدخل واحد على الأقل.
كل طلب يرسله الفحص يُسجَّل — الرابط والطريقة وحالة الاستجابة والترويسات ذات الصلة ومعاينة للجسم — ويُعرض تحت الفحص في نتائجك.
كيفية تنفيذه
Publish an API catalog for automated API discovery (RFC 9727)
يعيد /.well-known/api-catalog النوع application/linkset+json مع مدخل واحد على الأقل.
تعليمات التنفيذ خطوة بخطوة جزء من خطة Pro.
عرض الخططافحص موقعك
اعرف ما إذا كان هذا الفحص ينجح على نطاقك، مع الفحوصات الـ21 الأخرى.
فحوصات ذات صلة
اكتشاف OAuth
يكشف /.well-known/oauth-authorization-server أو /.well-known/openid-configuration بيانات وصفية قابلة للاستخدام.
OAuth Protected Resource
يعلن /.well-known/oauth-protected-resource الحقلين resource وauthorization_servers.
Auth.md
يوجد /auth.md وفيه عنوان Markdown من المستوى H1 يذكر auth.md.
MCP Server Card
يصف /.well-known/mcp/server-card.json الخادم عبر serverInfo.name.
A2A Agent Card
يعلن /.well-known/agent-card.json الاسم والإصدار والواجهات المدعومة.
Agent Skills
يُدرج /.well-known/agent-skills/index.json مهارة واحدة على الأقل.
WebMCP
يسجّل كود الصفحة أدوات على جانب المتصفح عبر navigator.modelContext.
بيان ARD
يعلن /.well-known/ai-catalog.json الحقول specVersion وhost ومدخلًا واحدًا على الأقل.