وثائق واجهة API العامة

موارد الاكتشاف

• /.well-known/api-catalog ينشر فهرس Linkset لاكتشاف واجهة API العامة.
• /.well-known/agent-skills/index.json ينشر فهرس Agent Skills Discovery RFC v0.2.0 للمهارات التي يتيحها هذا الموقع للوكلاء المتوافقين.
• /openapi.json ينشر وصف خدمة OpenAPI المشار إليه من فهرس API.
• /.well-known/mcp/server-card.json ينشر بطاقة MCP Server Card لاكتشاف الوكلاء، بما في ذلك هوية خادم Peptaura وإصدار البروتوكول المدعوم ونقطة نهاية النقل والقدرات المعلنة.
• /.well-known/mcp-server-card يقدّم بطاقة MCP Server Card نفسها على مسار التوافق الأحدث الذي تستخدمه مسودة SEP النشطة.
• /mcp يكشف عن نقل MCP عام عبر Streamable HTTP يدعم حاليًا التهيئة وping واستجابات اكتشاف فارغة للأدوات والموارد والمطالبات لعملاء الوكلاء.
• /.well-known/http-message-signatures-directory ينشر Web Bot Auth JWKS الخاص بالموقع لطلبات الروبوتات والوكلاء الموقعة.
• /.well-known/openid-configuration يعيد التوجيه إلى مستند اكتشاف Supabase Auth OpenID Connect الأساسي المستخدم لمصادقة الوكلاء وعملاء OAuth.
• /.well-known/oauth-authorization-server يعيد توجيه العملاء الموجهين إلى OAuth إلى مستند اكتشاف Supabase Auth المباشر نفسه المستخدم حاليًا لـ OpenID Connect.
• /.well-known/oauth-protected-resource ينشر بيانات وصفية لمورد محمي وفق RFC 9728 تتضمن معرّف مورد هذا الموقع ومُصدر Supabase Auth ونطاقات OAuth/OIDC المدعومة التي ينبغي للوكلاء طلبها.
• /llms.txt يوفر سياقًا إضافيًا قابلًا للقراءة آليًا على مستوى الموقع للوكلاء.
• تدعم صفحات HTML العامة أيضًا Cloudflare Markdown for Agents. أرسل Accept: text/markdown إلى اسم مضيف الإنتاج لتلقي تمثيل Markdown مع استجابة Content-Type: text/markdown ورأس x-markdown-tokens عندما توفر Cloudflare واحدًا.

تكامل المختبر

/docs/lab-integration.md هو دليل الشركاء لمختبرات الاختبار المعتمدة. يوثق طلب POST الصادر الاختياري الذي ترسله Peptaura إلى مستقبِل HTTPS الخاص بالمختبر بعد تأكيد دفعة المختبر، وتدفق تحميل النتائج الموثّق في /lab، وواجهة الشريك الواردة المقيدة بالمختبر: GET /api/lab/v1/orders/{clientOrderReference} للبحث عن الطلبات و POST /api/lab/v1/orders/{clientOrderReference}/results لإرسال التقارير متعددة الأجزاء. تتطلب نقاط النهاية الواردة اعتماد Bearer صادرًا عن المختبر ولا تكشف إلا الطلبات المدفوعة الخاصة بذلك المختبر؛ فهي واجهات شركاء وليست نقاط نهاية عامة غير موثقة مثل الواردة أدناه.