لماذا يهم
- ترويسة
Link(RFC 8288) تقول لمن يقرأ الرد أين يجد ما يخص الصفحة. وبعض علاقاتها تدل الوكلاء على وصف الواجهة البرمجية (service-desc) وتوثيقها (service-doc) وحالتها (service-meta) ووصف المورد (describedby) وفهرس الواجهات (api-catalog) وفهرس الوكلاء (ard). - العلاقات الأخرى، مثل
preconnectوpreload، للمتصفح لا للوكيل. - هذه معلومة: موقع بلا واجهات للوكلاء لا يحتاجها.
كيف تُصلح
أرسل مع الصفحة الرئيسية روابط إلى ما تقدمه للوكلاء:
http
Link: </.well-known/api-catalog>; rel="api-catalog", </openapi.json>; rel="service-desc", </docs/api>; rel="service-doc"كيف نكشف
في أداة جاهزية الوكلاء وحدها: نقرأ ترويسة Link في رد الصفحة كما وصلنا، ونبحث فيها عن واحدة من العلاقات: service-desc وservice-doc وservice-meta وdescribedby وapi-catalog وard وai-catalog.
المراجع
- RFC 8288: ربط الويب Web Linking (بالإنجليزية)
- RFC 8631: علاقات الروابط لوصف خدمات الويب (بالإنجليزية)
- RFC 9727: api-catalog (بالإنجليزية)