ضمِّن بحث LiKE بالذكاء الاصطناعي في تطبيقاتك أو موقعك أو أنظمتك الداخلية. ثلاث طرق للتكامل: REST API، أداة JS، iframe.
#REST API
#الخطوة 1 — إنشاء مفتاح API
- التكاملات ← Public API ← "إنشاء مفتاح"
- أدخِل اسمًا (على سبيل المثال، "تطبيق الجوال")
- انسخ المفتاح — يُعرض مرة واحدة فقط
#الخطوة 2 — استخدام API
تُصرَّح جميع الطلبات عبر الترويسة:
X-API-Key: your-key#نقاط النهاية الأساسية
| نقطة النهاية | الطريقة | الوصف |
|---|---|---|
/api/public/search |
POST | بحث بالذكاء الاصطناعي في قاعدة المعرفة |
/api/public/articles |
GET | قائمة المقالات |
/api/public/articles/{id} |
GET | محتوى المقالة |
#مثال: البحث بالذكاء الاصطناعي
curl -X POST https://amedia.lynkora.pro/api/public/search \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Как оформить отпуск?"}'الاستجابة:
{
"answer": "Для оформления отпуска...",
"sources": [
{"title": "Политика отпусков", "url": "..."}
]
}#حدود المعدل
تُقيَّد طلبات API لكل مفتاح. يعتمد الحد المحدد على خطتك؛ عند تجاوزه، يُرجَع HTTP 429 مع ترويسة Retry-After. القيم الدقيقة لخطتك في قسم الخطة.
#الأمان
- خزِّن المفاتيح في متغيرات البيئة، لا في الكود
- أنشئ مفتاحًا منفصلًا لكل تطبيق
- احذف المفاتيح غير المستخدمة
- قيِّد النطاقات في إعدادات المفتاح
#أداة JS
زر بحث عائم بالذكاء الاصطناعي للتضمين في أي موقع.
#الخطوة 1 — الحصول على الكود
- التكاملات ← JS Widget
- اضبط المعاملات (انظر الجدول أدناه)
- انسخ الكود
#الخطوة 2 — إضافته إلى موقعك
أدرِج <script> المنسوخ قبل وسم </body> الختامي:
#معاملات الأداة
| المعامل | القيمة | الوصف |
|---|---|---|
data-key |
wk_live_... |
مطلوب. مفتاح الأداة (يُنشأ في التكاملات ← JS Widget). بدونه، لن تبدأ الأداة |
data-position |
bottom-right / bottom-left / none |
موضع الزر العائم (الافتراضي bottom-right) |
data-theme |
light / dark / auto |
السمة المرئية (الافتراضي light) |
data-lang |
ru / en / de / es / fr / ar |
لغة الواجهة (الافتراضي — يُكتشف تلقائيًا من المتصفح) |
data-hotkey |
k |
مفتاح الفتح مع Cmd/Ctrl (الافتراضي k ← Cmd/Ctrl + K) |
data-session-token |
JWT | اختياري. رمز الجلسة لوضع الهوية لكل مستخدم (انظر "مقارنة أوضاع المصادقة" أدناه) |
#النتيجة
يظهر زر بنفسجي في زاوية موقعك. انقر ← نافذة منبثقة بشريط بحث ← إجابة بالذكاء الاصطناعي من قاعدة معرفتك.
#iframe
واجهة بحث كاملة الميزات مضمَّنة في صفحتك:
#كود التضمين
#رابط مباشر
إذا لم يناسبك iframe، امنح المستخدمين رابطًا مباشرًا: https://amedia.lynkora.pro
#الوضع التجريبي
للاختبار دون مفتاح API، تتوفر نقطة نهاية تجريبية بقيود:
| المعامل | القيمة |
|---|---|
| الطلبات في الساعة | 7 |
| الطلبات في اليوم | 15 |
| التصريح | غير مطلوب (مقيّد بعنوان IP) |
نقطة النهاية: POST /api/public/demo/search
#مقارنة أوضاع المصادقة
تدعم الأداة وضعَي مصادقة.
#الوضع A — الثقة بمنطقة الرابط
مصادقة من جانب العميل: أنت مسؤول عمّن يصل إلى الصفحات التي تحوي الأداة (VPN، SSO، مسارات محمية). لا تعرف Lynkora هوية المستخدم — فقط Origin/IP الخاص بالطلب. الأداة مرئية لكل من يفتح صفحة تحوي كود التضمين.
- كود الخلفية: 0 سطر
- زمن الإعداد: ~دقيقتان
- مناسب لـ: الشبكة الداخلية، البوابة الداخلية
#الوضع B — رمز الجلسة (JWT لكل مستخدم)
تُصدِر خلفيتك رمز جلسة قصير الأمد لكل مستخدم. تعرف Lynkora الهوية، وتحتفظ بتدقيق لكل مستخدم، وتدعم الإبطال وطلبات GDPR DSAR.
- كود الخلفية: ~10 أسطر (عبر SDK)
- زمن الإعداد: 1–2 ساعة
- مناسب لـ: SaaS متعدد المستأجرين، الصناعات المنظَّمة
| الوضع A — منطقة الرابط | الوضع B — رمز الجلسة | |
|---|---|---|
| هوية المستخدم | لا (Origin/IP فقط) | نعم (JWT لكل مستخدم) |
| التدقيق لكل مستخدم | لا | نعم |
| الإبطال / GDPR DSAR | لا | نعم |
| كود الخلفية | 0 سطر | ~10 أسطر (SDK) |
| الإعداد | ~دقيقتان | 1–2 ساعة |