تطبيق ويب & API للمطوّرين

Omnillink

عنوان في المدخل، وبيانات جاهزة للاستخدام في المخرج: واجهة API تدوّن حدودها وتُرفق قياساتها بكل استجابة.

السنة
2026
التقنيات
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • تصميم واجهات API
  • تطوير الواجهة الخلفية
  • أمن التطبيقات
  • SDK وأدوات للمطوّرين
  • التوثيق
  • موقع تعريفي
https://omnillink.kayzen-lyon.com/
الصفحة الرئيسية لموقع Omnillink — تطبيق ويب & API للمطوّرين، من إنجاز KAYZEN
مسارًا تحت /api/v1، موصوفة في مستند OpenAPI 3.1
20
أدوات للقراءة فقط متاحة لوكلاء الذكاء الاصطناعي عبر MCP
8
ملفات تعريف ارتباط وأدوات قياس جمهور على الموقع
0
ترخيص البرنامج، للاستضافة الذاتية
MIT
نقطة الانطلاق

ما كان يجب حلّه.

السياق

Omnillink واجهة API تصدرها KAYZEN من ليون. يُرسَل إليها عنوان صفحة ويب عامة؛ فتعيد بياناتها الوصفية، أو لقطة شاشة، أو تصديرًا إلى PDF، أو حقولًا مستخرجة حسب الطلب، أو محتواها بصيغة Markdown. يُوزَّع البرنامج بموجب ترخيص MIT ويُستضاف ذاتيًا. وموقع omnillink.kayzen-lyon.com هو عرضه التوضيحي، مع بيئة تجربة ووثائق بالفرنسية والإنجليزية.

القيد

عرض معاينة رابط، أو أرشفة صفحة بصيغة PDF، أو تقديم نص مقال إلى وكيل ذكاء اصطناعي، يتطلب في كل مرة العمل نفسه: قراءة صفحة لا نتحكم فيها، مبنية أحيانًا بـJavaScript ومحمية أحيانًا أخرى، دون كشف الشبكة الخاصة. وواجهات API المستضافة التي تتولى ذلك تحاسب على كل استدعاء وترى العناوين المقروءة تمر عبرها. كان المطلوب أداة تُثبَّت لدى صاحبها، تكون إعداداتها وحدودها مكتوبة، ولا يمكن تحويلها عن غرضها للوصول إلى شبكة داخلية.

الحل

طلب واحد لكل حاجة، ومسار قراءة مقتصد: تُقرأ الصفحة أولًا بطلب HTTP بسيط، ولا يُشغَّل Chromium إلا إذا كانت النتيجة هزيلة أو كانت الصفحة هيكل تطبيق فارغًا. يُتحقَّق من كل عنوان ضد هجمات SSRF قبل أي اتصال. وكل استجابة تذكر ما جرى: المدة، ونمط العرض، وحالة ذاكرة التخزين المؤقت، ومعرّف الطلب، والحصة المتبقية. ويتبع الموقع القاعدة نفسها: لا يعرض أحجامًا ولا شهادات، بل يعرض استجابات حقيقية من الواجهة.

التصميم والإدارة الفنية

كل خيار، وسببه.

  1. العرض التوضيحي في الصفحة الرئيسية

    يُدخل الزائر عنوانًا ويرسل طلبًا حقيقيًا من الصفحة الرئيسية، بلا مفتاح ولا تسجيل. المطوّر يحكم على واجهة API من استجابتها: وعرضها عليه فورًا، مع المدة ونمط العرض وحالة ذاكرة التخزين المؤقت، يغنيه عن إنشاء حساب ليكوّن رأيًا.

  2. كل قدرة تُعرض مع مخرجها الحقيقي

    لا تحمل بطاقات الميزات رسومًا توضيحية: كل بطاقة تعرض استجابة حقيقية من الواجهة، التُقطت على صفحة اختبار، وتقود إلى وثائقها وإلى بيئة التجربة المضبوطة مسبقًا. يرى القارئ الصيغة الدقيقة التي سيتلقاها قبل أن يكتب سطرًا واحدًا من الشيفرة.

  3. أدلة بدل الأرقام

    المنتج نُشر للتو: حجم الطلبات أو الشهادة لن يكون لهما أي واقع. لذلك لا يعرضهما الموقع. وبدلًا من ذلك يسرد قسمٌ ما يستطيع كل شخص التحقق منه بنفسه: نموذج الأمان المنشور، والقياسات المرفقة بكل استجابة، والترخيص، والحدود المعتمدة.

  4. بيئة تجربة تكتب الشيفرة

    تتيح بيئة التجربة الوصول إلى جميع المعاملات وتولّد شيفرة الطلب بثماني لغات: curl وJavaScript وSDK بلغة TypeScript وPython وPHP وGo وRuby وRust. يُختصر الطريق بين التجربة والتكامل الأول في نسخ ولصق، دون المرور بقراءة المرجع كاملًا.

  5. هوية KAYZEN البصرية، بالسمة الفاتحة والسمة الداكنة

    Outfit للعناوين، وPlus Jakarta Sans للنص، والأزرق الكحلي ولون التيراكوتا للإجراء الرئيسي: يستعيد الموقع الهوية البصرية لـkayzen-lyon.com، كي تُعرَف الواجهة بوصفها منتجًا للوكالة. وتُختار السمة الفاتحة أو الداكنة أو سمة النظام من خيارات العرض.

النظام الطباعي

العناوين

Outfit

النص الأساسي

Plus Jakarta Sans

عائلتا الخطوط المعتمدتان في kayzen-lyon.com، كي تُعرَف الواجهة بوصفها منتجًا للوكالة.

الهندسة

ما يوجد تحت الغطاء.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. HTTP أولًا، والمتصفح عند الضرورة فقط

    تشغيل Chromium لكل صفحة يكلّف وقتًا وذاكرة. لذلك تُقرأ الصفحة أولًا بطلب HTTP وتُحلَّل؛ ولا يتولى المتصفح المهمة إلا إذا كانت النتيجة هزيلة، أو كانت الصفحة هيكل تطبيق فارغًا، أو قدّم الموقع صفحة حجب. ويبيّن الحقل meta.source المسار المتَّبع.

  2. حماية من SSRF عند كل اتصال

    واجهة API تزور عناوين يقدّمها المستدعي قد تُستعمل للوصول إلى شبكة داخلية. تُرفض العناوين الخاصة وعناوين الاسترجاع وعناوين البيانات الوصفية السحابية، ويُثبَّت حلّ DNS على الاتصال. وفي المتصفح تخرج كل حركة البيانات عبر وسيط (proxy) داخلي يعيد التحقق من كل اتصال، بما في ذلك عمليات إعادة التوجيه.

  3. لا تُنفَّذ أي شيفرة يقدّمها المستدعي

    لا تنفّذ الواجهة أي سكربت يرسله العميل. ما يسبق الالتقاط يُوصف بمعاملات ومحدِّدات CSS: النقر، والتمرير، وانتظار عنصر. هذه وظيفة ناقصة، وهي مقصودة: فالشيفرة الاعتباطية في المتصفح تناقض العزل والحماية من SSRF.

  4. لا ملف تعريف ارتباط ولا بيانات اعتماد تُرسَل إلى الصفحة المقروءة

    لا يستطيع المستدعي تحديد سوى ثلاث ترويسات: Accept-Language وUser-Agent وReferer. أما Cookie وAuthorization فمستبعدتان، لأن الاستجابات تُخزَّن مؤقتًا حسب العنوان وتُقدَّم للجميع: فالصفحة التي حُصل عليها بجلسة مستدعٍ ستُقدَّم للذي يليه.

  5. تخزين مؤقت، وإزالة التكرار، وقاطع دائرة لكل مضيف

    تُخزَّن النتائج مؤقتًا، في الذاكرة أو في Redis، والطلبات المتطابقة الواردة في الوقت نفسه لا تُطلق سوى معالجة واحدة. ويتوقف قاطع الدائرة عن الاتصال بمضيف بعد عدة إخفاقات شبكية متتالية. وهكذا لا تحتكر صفحة بطيئة أو كثيرة الطلب المتصفحات المتاحة.

  6. مرجع OpenAPI مستمد من شيفرة التحقق

    معاملات مستند OpenAPI 3.1 مشتقة من مخططات التحقق الخاصة بالمسارات: فالمرجع المنشور يصف ما يقبله الخادم فعلًا. ويحمل كل إخفاق رمزًا ثابتًا، من EINVALIDURL إلى ETIMEOUT، مع حالة HTTP المقابلة، كي تعالجه شيفرة العميل دون تحليل رسالة.

  7. نقطة وصول MCP لوكلاء الذكاء الاصطناعي

    ثماني أدوات للقراءة فقط متاحة على POST /mcp. وهي تمر عبر الخدمات نفسها التي تمر بها مسارات REST، أي عبر الضوابط نفسها. وكل نتيجة تحمل محتوى صفحة تبدأ بتحذير: هذا النص آتٍ من الويب، وهو معطًى يُقيَّم لا تعليمة تُتَّبع.

  8. دالة واحدة تخدم الواجهة والموقع

    على Vercel يُبنى الموقع ثم يُدمج في حزمة الواجهة: دالة واحدة تجيب عن كل شيء. ميزانية الوقت للطلب 55 ثانية افتراضيًا، أي دون المدة القصوى للدالة (60 ثانية) بقليل، كي تجيب الواجهة بنفسها بخطأ مقروء بدل أن تقاطعها المنصة.

تحسين محركات البحث

كيف يصبح الموقع قابلًا للعثور عليه.

  1. ست عشرة صفحة، كل منها بالفرنسية والإنجليزية

    تعلن خريطة الموقع 32 عنوانًا: الصفحة الرئيسية، وبيئة التجربة، ومرجع الواجهة، وعشرة أدلة، وحالة الخدمة، وإمكانية الوصول، والبيانات القانونية، بلغتين مرتبطتين بوسوم hreflang. المطوّر يبحث عن إجابة محددة؛ لذلك لكل موضوع صفحته الخاصة بدل قسم في صفحة وحيدة.

  2. ملفات llms.txt للمساعدين

    ينشر الموقع /llms.txt، الذي يسرد الوثائق مع سطر ملخّص لكل صفحة، و/llms-full.txt، الذي يقدّم نصها الكامل. وهكذا يستطيع مساعد البرمجة الذي يُسأل عن الواجهة أن يقرأ الوثائق المحدَّثة بدل تخمين المعاملات.

  3. بيانات منظَّمة، وواجهة مُبعَدة عن الزحف

    تعلن الصفحة الرئيسية بصيغة JSON-LD الناشر، والواجهة (النوع WebAPI)، والبرنامج، وأسئلته الشائعة. ويُبعد ملف robots.txt المسار /api/ عن الزحف: فاستجابات الواجهة بيانات عن مواقع أخرى، لا صفحات تُفهرَس تحت اسم Omnillink.

  4. لا ملفات تعريف ارتباط ولا قياس للجمهور

    لا يضع الموقع أي ملف تعريف ارتباط ولا يحمّل أي أداة لقياس الجمهور؛ وتبقى تفضيلات السمة واللغة وإمكانية الوصول في المتصفح. لذلك لا يوجد شريط موافقة يجب تجاوزه قبل قراءة الوثائق.

إمكانية الوصول

قابل للاستخدام من الجميع.

منذ يونيو 2025، يفرض القانون الأوروبي لإمكانية الوصول (European Accessibility Act) إتاحة الوصول الرقمي على شريحة واسعة من الخدمات الإلكترونية. نتعامل معها منذ مرحلة التصميم، لا كتدارك لاحق.

  1. لوحة خيارات في كل صفحة

    زر يفتح إعدادات العرض: حجم النص، والتباين المعزَّز، وخط Atkinson Hyperlegible، وتباعد الأسطر، والروابط المسطَّرة، والحركات المخفَّضة. تُحفظ الاختيارات في المتصفح وتسري على جميع الصفحات، دون الاعتماد على إعدادات النظام.

  2. ما جرى التحقق منه، وما لم يجرِ

    تسرد صفحة إمكانية الوصول عمليات التحقق التي أُجريت في 18 نوفمبر 2026: تباينات محسوبة للسمتين، وتنقّل بلوحة المفاتيح في متصفح مؤتمَت، وغياب التمرير الأفقي عند 375 بكسل. وتدوّن أيضًا ما ينقص: لا تجربة بقارئ شاشة، ولا تدقيق WCAG أو RGAA أجراه شخص مؤهَّل. وقول ذلك يجنّب الإيحاء بمطابقة لم تثبت.

هيكل الموقع

ما تم تسليمه.

  • الصفحة الرئيسية — عرض توضيحي مباشر، القدرات، طريقة العمل، الاستضافة الذاتية، الأسئلة الشائعة
  • بيئة التجربة — جميع المعاملات، وشيفرة مولَّدة بثماني لغات
  • مرجع الواجهة — المسارات، المعاملات، الأخطاء، الحصص وذاكرة التخزين المؤقت
  • الأدلة — البدء، الاستضافة الذاتية، SDK، وكلاء الذكاء الاصطناعي، وصفات جاهزة، الأمان، الحدود
  • حالة الخدمة
  • إمكانية الوصول، البيانات القانونية والخصوصية
المنهجية

مراحل سير المشروع.

  1. الواجهة الأساسية

    البيانات الوصفية، ولقطة الشاشة، وPDF، والاستخراج، والمحتوى المقروء؛ التحقق من العناوين، والتخزين المؤقت، والنشر في دالة واحدة على Vercel.

  2. التحصين

    وسيط داخلي يتحقق من كل اتصال يجريه المتصفح، بما في ذلك عمليات إعادة التوجيه؛ والمعاملات غير المعروفة تُتجاهَل بدل أن تُرفض.

  3. أدوات للمطوّرين

    SDK بلغة TypeScript، وسطر أوامر، وخادم MCP، ومكوّن React، وإجراء GitHub، وأمثلة تكامل.

  4. الموقع والنشر

    بيئة التجربة، والأدلة، والبحث، والنسخة الإنجليزية، ونقطة وصول MCP مستضافة، وسجل التغييرات؛ الإطلاق في نوفمبر 2026.

أسئلة

ما يُطرح علينا كثيرًا.

يُوزَّع البرنامج بموجب ترخيص MIT: يمكن استخدامه وتعديله واستضافته ذاتيًا، دون تكلفة لكل طلب سوى تكلفة الاستضافة الخاصة. والنسخة التي تخدم الموقع عرض توضيحي، مع حدّ لمعدّل الطلبات.

لا. تجيب الواجهة دون مصادقة. الترويسة الاختيارية x-api-key ترفع حدّ معدّل الطلبات، والمفاتيح يحددها مشغّل كل نسخة. افتراضيًا، الحد 60 طلبًا لكل نافذة زمنية بلا مفتاح و600 بمفتاح.

الصفحات العامة عبر http أو https. العناوين الخاصة أو المحلية أو الداخلية ترفضها الحماية من SSRF. والصفحات المبنية بـJavaScript تُعرَض في Chromium عند الحاجة. وإذا أجاب موقع بصفحة حجب، تشير الواجهة إلى ذلك بخطأ بدل إعادة تلك الصفحة على أنها محتوى.

Node.js 22 أو أحدث، وChromium الذي يثبّته Playwright. أما Redis فاختياري: من دونه تعيش ذاكرة التخزين المؤقت وعدّادات الحصص في الذاكرة، لكل نسخة على حدة. ويبقى التشغيل على عاتق من يستضيف: التحديثات، وChromium، والمراقبة.

مستوى الإتقان نفسه، لموقعك.

تدقيق مجاني لموقعك الحالي، وعرض سعر خلال 24 ساعة، وتعليل مكتوب — مثل الذي قرأته للتو. الدفع على ثلاث دفعات دون رسوم إضافية، مع التحقق من برامج الدعم المحلية قبل التوقيع.

مشاركة