موارد عامة للقراءة فقط
تُعرض الصفحات العامة من الخادم، ولها روابط أساسية لكل لغة، وتتضمن بيانات منظمة عند الاقتضاء. يحتوي موجز المعرفة أدناه على الأدلة والإجابات العامة نفسها الظاهرة في هذا الموقع. ولا يتضمن الحسابات أو الرسائل الخاصة أو ملفات التسليم أو بيانات المعاملات.
- GET /knowledge.json — سجلات الصفحات والأسئلة العامة مع رقم إصدار، وروابط أساسية، ولغة، وتاريخ تحديث.
- GET /llms.txt — دليل موجز لموارد السوق الرسمية.
- GET /sitemap.xml — الصفحات العامة المنشورة وروابط الأفلام باللغات المدعومة.
- صفحات المشاريع — معرّفات INDEX العامة وروابط المصادر ومعلومات المشروع المتاحة.
مواصفات موجز المعرفة
استخدم الحقل schemaVersion لاكتشاف تغيير الصيغة. تتضمن كل صفحة حقول path وurl وtitle وdescription وsections وquestions مع مسار ثابت. ويتضمن كل سؤال id وquestion وanswer ورابط خطوة تالية اختياري. يقبل معامل lang لغة مدعومة، مثل /knowledge.json?lang=zh-Hant. تُرجع اللغات غير المدعومة HTTP 400. استخدم الطلبات المشروطة مع ترويسة ETag؛ وتُرجع الموارد التي لم تتغير HTTP 304.
عند عرض إجابة، استشهد برابط الصفحة الأساسي ولغتها وتاريخ تحديثها. حافظ على القيود المتعلقة بالحقوق وتوفر الخدمة والأرقام المنسوبة إلى مصادرها. لا يمنح الوصول العام إلى البيانات الوصفية ترخيصاً لإعادة استخدام فيلم أو ملصق أو أصل إبداعي آخر.
curl -i 'https://hkaiiff.market/knowledge.json?lang=ar'التكاملات الخاصة وصلاحية الكتابة
نقاط التطبيق التي تتطلب المصادقة هي إجراءات خاصة بالتطبيق، وليست واجهة عامة للشركاء. لا يتوفر حالياً إصدار عام لمفاتيح المطورين أو واجهة شراء خارجية أو تكامل للتسوية التلقائية. قبل تمكين الكتابة، يحتاج أي تكامل مقترح إلى بيانات اعتماد محصورة بالمؤسسة، وأقل قدر من الصلاحيات، وإجراءات لا تتكرر آثارها عند إعادة الطلب، وسجل تدقيق، واتفاق مستقل.
أبلغ عن مشكلة تقنية أو أمنية
أرسل الرابط العام المتأثر والتوقيت والنتيجة المتوقعة وأبسط خطوات إعادة المشكلة إلى business@hkaiiff.org. للمشكلات الأمنية، أرسل وصفاً أولاً واطلب قناة خاصة للأدلة. لا تُرفق رموز الوصول أو رموز تسجيل الدخول أو المفاتيح الخاصة أو بيانات مؤسسة أخرى. ولا تُجرِ اختبارات تخريبية أو تجمع سجلات خاصة على نطاق واسع.