API Catalog
API catalog आपकी API की सूची देता है और RFC 9727 के linkset फ़ॉर्मैट में हर एक के विवरण, डॉक्युमेंटेशन और स्टेटस एंडपॉइंट की ओर इशारा करता है।
यह क्यों मायने रखता है
जिस एजेंट ने आपका प्रोडक्ट कभी देखा ही नहीं, वह आपकी मार्केटिंग साइट पढ़े बिना इसी से जानता है कि आपके पास API है।
पास मानदंड
/.well-known/api-catalog, application/linkset+json लौटाता है, जिसमें कम से कम एक प्रविष्टि हो।
जाँच जो भी अनुरोध करती है, वह सब दर्ज होता है — URL, मेथड, रिस्पॉन्स स्टेटस, संबंधित हेडर और बॉडी का प्रीव्यू — और नतीजों में उस जाँच के नीचे दिखाया जाता है।
इसे कैसे लागू करें
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, name, version और समर्थित इंटरफ़ेस घोषित करता है।
Agent Skills
/.well-known/agent-skills/index.json में कम से कम एक स्किल सूचीबद्ध है।
WebMCP
पेज का कोड navigator.modelContext के ज़रिए ब्राउज़र-साइड टूल्स रजिस्टर करता है।
ARD मैनिफ़ेस्ट
/.well-known/ai-catalog.json, specVersion, host और कम से कम एक प्रविष्टि घोषित करता है।