عند تطوير تطبيقات الويب، لا يسير Frontend وBackend دائما بالسرعة نفسها. قد تكون الواجهة الأمامية جاهزة لعرض قوائم المستخدمين أو المنتجات، بينما لا تزال واجهات REST API قيد التطوير. في هذه الحالة، يستطيع المطور استخدام Mock API لتوفير استجابات تجريبية تساعده على مواصلة بناء الواجهة واختبار تعاملها مع الطلبات المختلفة.
طورنا KERLION API Mock Studio لتوفير مساحة عمل بسيطة داخل المتصفح تساعد المطور على تعريف REST-style Endpoints، وتحديد HTTP Methods وحالات الاستجابة، وإنشاء JSON Response Bodies، ثم اختبار كيفية مطابقة الطلبات مع هذه التعريفات.
لكن من المهم فهم نطاق المشروع منذ البداية: KERLION API Mock Studio ليست HTTP Server، ولا تنشئ Public API Endpoint يمكن لتطبيق خارجي الاتصال به عبر الشبكة. المحاكاة واختبار مطابقة الطلبات يتمان داخل واجهة المشروع في المتصفح.
في هذا الدليل، نوضح مفهوم Mock API، ثم ننتقل إلى إنشاء Endpoints واستخدام HTTP Methods وPath Parameters وJSON Responses وResponse Headers، واختبار Request Matching، وحفظ مساحة العمل واستيرادها وتصديرها، مع توضيح الحالات المناسبة لاستخدام المشروع وحدوده التقنية.
ما هو Mock API؟ ولماذا يحتاج إليه مطورو Frontend؟
ما المقصود بـ API Mocking؟
الـAPI هو الواجهة التي تسمح لتطبيق بالتواصل مع وظائف أو بيانات يوفرها نظام آخر. وفي تطبيقات الويب، يعتمد Frontend عادة على REST API للحصول على البيانات أو إرسالها إلى Backend.
لكن أثناء التطوير قد لا يكون Backend جاهزًا بعد، أو قد تكون بعض المسارات المطلوبة للواجهة لم تُنفذ بعد. هنا يظهر مفهوم API Mocking.
يقصد بـ API Mocking إنشاء تمثيل تجريبي لسلوك API المتوقع، مثل تعريف مسار معين، وتحديد طريقة HTTP، وحالة الاستجابة، والبيانات التي يفترض أن تعود إلى التطبيق.
على سبيل المثال، يمكن تعريف Endpoint مثل:
GET /api/users
مع Response Body بصيغة JSON:
{
"data": [
{
"id": 1,
"name": "Ahmed"
},
{
"id": 2,
"name": "Sara"
}
]
}
بهذه الطريقة يستطيع المطور تصور الاستجابة التي يتوقعها Frontend والتعامل معها أثناء التطوير، حتى قبل اكتمال Backend الحقيقي.
لماذا تحتاج إلى Mock API أثناء تطوير Frontend؟
من أكثر المشكلات شيوعًا في تطوير التطبيقات أن الواجهة الأمامية تحتاج إلى API قبل اكتمال الجزء الخلفي من النظام.
قد تكون لديك صفحة تعرض قائمة المستخدمين، ومكون لعرض تفاصيل منتج، ونماذج ترسل بيانات إلى Backend، بينما لا تزال Endpoints المقابلة قيد التنفيذ.
بدل إيقاف تطوير Frontend حتى اكتمال هذه الواجهات، يمكن إعداد بيانات واستجابات تجريبية تمثل الشكل المتوقع للـAPI.
وتفيد هذه الطريقة في حالات مثل:
- تطوير واجهة المستخدم قبل جاهزية Backend.
- اختبار عرض بيانات JSON داخل مكونات Frontend.
- تجربة حالات HTTP مختلفة.
- اختبار المسارات التي تحتوي على Path Parameters.
- التحقق من تعامل الواجهة مع استجابات النجاح أو الخطأ.
- إنشاء أمثلة ثابتة يمكن الرجوع إليها أثناء التطوير.
وهنا تأتي فائدة KERLION API Mock Studio باعتبارها مساحة محلية لتعريف هذه الاستجابات واختبار مطابقة الطلبات لها.
الفرق بين Mock API وReal API
رغم أن Mock API يحاكي شكل API الحقيقي، فإن الاثنين ليسا الشيء نفسه.
| وجه المقارنة | Mock API | Real API |
|---|---|---|
| مصدر الاستجابة | بيانات تجريبية محددة مسبقًا | Backend فعلي |
| تنفيذ منطق التطبيق | محدود بالمحاكاة والإعدادات | ينفذ منطق النظام |
| قاعدة البيانات | لا توجد عملية CRUD حقيقية | يمكن أن يتعامل معها Backend |
| الاتصال الشبكي | يعتمد على طريقة تنفيذ أداة المحاكاة | يتصل بخادم API |
| الهدف | التطوير والاختبار والمحاكاة | تشغيل وظائف التطبيق الفعلية |
في حالة KERLION API Mock Studio، يجب أن يكون الفرق أكثر وضوحا: المشروع لا يشغل HTTP Server حقيقيا ولا ينشئ عنوان API عاما. فهو يحاكي مطابقة الطلبات داخل المتصفح ويعرض الاستجابة الثابتة التي أعددتها للمسار المطابق.
ما هي KERLION API Mock Studio وما الذي تقدمه للمطور؟
KERLION API Mock Studio هي مساحة عمل مجانية ومفتوحة المصدر تعمل داخل المتصفح، طورناها لمساعدة المطورين على تعريف REST-style Endpoints وإنشاء أمثلة لاستجابات JSON واختبار مطابقة الطلبات لهذه التعريفات.
يمكنك باستخدام المشروع إنشاء تعريفات متعددة وإدارتها، ثم ضبط الطريقة والمسار وحالة الاستجابة ومحتوى JSON والترويسات الاختيارية.
الوظائف الأساسية للأداة
يوفر المشروع مجموعة من الوظائف التي تغطي سيناريوهات Mock API المحلية، ومنها:
- إنشاء Mock Endpoint جديد.
- تعديل Endpoint موجود.
- البحث عن تعريفات Endpoints.
- حذف Endpoints.
استخدام HTTP Methods التالية:
- GET
- POST
- PUT
- PATCH
- DELETE
استخدام Path Parameters مثل:
/api/users/:id
- تحديد HTTP Status Code للاستجابة.
- تعريف JSON Response Body.
- إضافة Response Headers اختيارية.
- اختبار Request Matching من خلال Local Playground.
- حفظ تغييرات Workspace تلقائيًا في Local Storage.
- استيراد Workspace من ملف JSON.
- تصدير Workspace إلى ملف JSON.
- استخدام واجهة متجاوبة مع أجهزة الكمبيوتر والهواتف.
كما لا يتطلب المشروع حساب مستخدم أو عملية Build لتشغيله، ولا يعتمد على Backend خاص بالمشروع أو خدمات خطوط خارجية أو مكتبات JavaScript خارجية.
تقنيات وخصائص تشغيل الأداة
تم تصميم KERLION API Mock Studio ليكون مشروعًا ثابتًا يمكن تشغيل ملفاته مباشرة في متصفح حديث.
لذلك لا تحتاج إلى إعداد Backend خاص لتشغيل واجهة المشروع نفسها. يمكنك تنزيل الملفات وفتح index.html في متصفح حديث، أو تقديم مجلد المشروع من خلال Static Web Server إذا كان ذلك مناسبًا لبيئة التطوير لديك.
يدعم المشروع المتصفحات الحديثة التي توفر APIs المستخدمة في التطبيق، مثل Chrome وEdge وFirefox وSafari.
ما الفرق بين Playground وخادم API حقيقي؟
هذه النقطة مهمة جدًا عند استخدام المشروع.
في KERLION API Mock Studio، يوجد Local Playground لاختبار كيفية مطابقة الطلب مع تعريفات Endpoints الموجودة في مساحة العمل. عندما يجد المشروع Route مطابقًا، يعرض الاستجابة المحددة لذلك الـEndpoint.
لكن هذا لا يعني أن المشروع شغّل Server يستقبل طلبات HTTP من التطبيقات الأخرى.
فالإصدار الحالي:
- لا يبدأ HTTP Server حقيقيا.
- لا ينشئ Network Endpoint.
- لا يوفر Public API URL.
- لا يسمح لتطبيق خارجي بالاتصال بالـMock API عبر الشبكة.
- لا ينشئ Response ديناميكية اعتمادًا على Request Body.
- لا ينفذ عمليات CRUD حقيقية على قاعدة بيانات.
لذلك يجب التعامل معه كبيئة محاكاة واختبار محلية داخل المتصفح، وليس كخادم Mock API قابل للاستهلاك من تطبيق آخر.
كيفية البدء باستخدام KERLION API Mock Studio
يمكنك الحصول على المشروع من مستودع KERLION API Mock Studio الرسمي على GitHub.
وإذا أردت استخدام الإصدار المشار إليه في هذا الدليل، فالمشروع متاح في صفحة الإصدار v1.0.1 على GitHub Releases.
تنزيل الأداة وتشغيلها
يمكنك تنزيل ملف الإصدار v1.0.1 مباشرة من ملف ZIP الرسمي للإصدار v1.0.1.
بعد الحصول على الملفات:
- فك ضغط المشروع.
- افتح ملف index.html في متصفح حديث.
- اختر Endpoint جاهزًا إذا كان موجودًا ضمن الأمثلة، أو أنشئ Endpoint جديدًا.
- عدّل Method والمسار وحالة الاستجابة وJSON Response والترويسات حسب الحاجة.
- استخدم Send request لاختبار مطابقة الطلب.
- استخدم Export إذا أردت الاحتفاظ بنسخة قابلة للنقل من Workspace.
كما يمكنك تقديم مجلد المشروع باستخدام Static Web Server إذا كنت تفضل تشغيله بهذه الطريقة.
التعرف على مساحة العمل
تتمحور مساحة العمل حول تعريفات Endpoints التي تنشئها وتعدلها أثناء استخدام المشروع.
لكل Endpoint إعدادات تحدد اسمه وطريقة HTTP والمسار وحالة الاستجابة ومحتوى Response، إضافة إلى Response Headers عند الحاجة.
وبدل إنشاء خادم Backend أو كتابة كود خاص لمحاكاة كل استجابة، يمكنك ضبط هذه القيم من داخل مساحة العمل واستخدام Local Playground للتحقق من مطابقة الطلبات.
البدء باستخدام Endpoint جاهز أو إنشاء Endpoint جديد
يمكنك البدء من تعريف Endpoint موجود وتعديله، أو إنشاء تعريف جديد يناسب سيناريو التطوير الذي تعمل عليه.
على سبيل المثال، إذا كنت تطور صفحة تعرض قائمة المستخدمين، يمكنك إنشاء:
GET /api/users
ثم تحديد Response Body تمثل البيانات التي تريد أن يتعامل معها Frontend.
كيفية إنشاء Mock Endpoint وإعداد REST-style Routes
إنشاء Endpoint هو الخطوة الأساسية لبناء مساحة Mock API داخل المشروع.
إنشاء Endpoint جديد
عند إنشاء Endpoint، تحدد مجموعة من القيم التي تصف الطلب والاستجابة المتوقعة.
ومن أهمها:
- اسم Endpoint.
- HTTP Method.
- Route Path.
- HTTP Status Code.
- Response Body.
- Response Headers الاختيارية.
بعد حفظ التعريف، يمكن استخدامه في اختبار Request Matching داخل Local Playground.
![]() |
| توضح الواجهة العناصر الأساسية التي يحددها المطور عند إنشاء Endpoint، من طريقة HTTP والمسار إلى حالة الاستجابة ومحتوى JSON. |
اختيار HTTP Method المناسب
يدعم المشروع طرق HTTP الشائعة التالية:
| HTTP Method | الاستخدام المعتاد |
|---|---|
GET |
محاكاة طلب قراءة بيانات |
POST |
محاكاة طلب إنشاء مورد |
PUT |
محاكاة استبدال مورد |
PATCH |
محاكاة تعديل جزء من مورد |
DELETE |
محاكاة طلب حذف مورد |
على سبيل المثال، يمكن تعريف:
GET /api/users
POST /api/users
GET /api/users/:id
DELETE /api/users/:id
لكن وجود هذه الطرق في تعريفات Mock لا يعني أن المشروع ينفذ عمليات إنشاء أو تعديل أو حذف حقيقية. فهو لا يتصل بقاعدة بيانات لتنفيذ CRUD، وإنما يستخدم التعريفات لمحاكاة الاستجابات واختبار المطابقة.
تحديد Route Path
يمكن تعريف مسارات ثابتة مثل:
/api/users
/api/products
كما يمكن استخدام Path Parameters:
/api/users/:id
وهذا يسمح بمحاكاة نمط شائع في REST API، حيث يمثل جزء من المسار معرف مورد معين.
من المهم أيضًا معرفة أن Query Strings وURL Fragments ليست جزءًا من تعريفات Route في الإصدار الحالي. لذلك لا ينبغي التعامل معها باعتبارها متغيرات يمكن إضافتها إلى تعريف المسار بالطريقة نفسها التي تستخدم بها Path Parameters.
تعديل Endpoint وحذفه والبحث عنه
لا تقتصر إدارة مساحة العمل على إنشاء Endpoints فقط. يمكنك تعديل التعريفات الموجودة أو حذفها، كما يوفر المشروع إمكانية البحث بين تعريفات Endpoints.
وهذا يصبح مفيدًا عندما تحتوي مساحة العمل على عدد كبير من المسارات الخاصة بأجزاء مختلفة من التطبيق.
كيفية إنشاء JSON Response وتحديد HTTP Status Codes
بعد تحديد المسار والطريقة، تحتاج إلى تحديد الاستجابة التي ستظهر عند العثور على Route مطابق.
إعداد Response Body بصيغة JSON
يسمح المشروع بتحديد Response Body بصيغة JSON.
على سبيل المثال:
{
"data": [
{
"id": 1,
"name": "Ahmed"
},
{
"id": 2,
"name": "Sara"
}
]
}
يمكن استخدام مثل هذه الاستجابة لتمثيل البيانات التي يتوقع Frontend الحصول عليها من Endpoint حقيقي.
الفكرة هنا ليست إنشاء بيانات حقيقية أو تنفيذ منطق Backend، وإنما تجهيز استجابة ثابتة تساعدك على اختبار الواجهة وسلوكها تجاه بنية البيانات المتوقعة.
اختيار HTTP Status Code
يمكنك تحديد Status Code المناسب لكل Endpoint.
فمثلًا يمكن إعداد:
200
لاستجابة ناجحة، أو:
201
عند محاكاة استجابة إنشاء مورد، أو استخدام حالات خطأ مثل:
400
404
500
بحسب السيناريو الذي تريد محاكاته.
هذه الإمكانية مفيدة عند اختبار Frontend، لأن الواجهة لا تتعامل فقط مع البيانات الموجودة في Response Body، بل قد تغير سلوكها بناءً على HTTP Status Code أيضًا.
العلاقة بين Status Code وResponse Body
يتيح لك المشروع تحديد Status Code وResponse Body ضمن تعريف Endpoint نفسه.
لذلك يمكنك إنشاء Endpoint يعرض بيانات JSON مع حالة نجاح، ثم إنشاء تعريف آخر يمثل حالة خطأ مع Status Code مختلف وResponse Body مناسبة.
لكن هذه الاستجابات تظل ثابتة وفق الإعدادات التي حددتها. المشروع لا يحولها إلى استجابات ديناميكية بناءً على منطق Backend أو بيانات قاعدة بيانات.
كيفية استخدام Path Parameters في Mock API
تعد Path Parameters من أهم العناصر عند محاكاة REST-style Routes، لأنها تسمح بتمثيل مسارات تتغير فيها قيمة جزء من URL.
ما المقصود بـ Path Parameters؟
في المسار:
/api/users/:id
يمثل :id جزءًا متغيرًا من المسار.
يمكن استخدام هذا النمط لتمثيل Endpoint يعرض مستخدمًا محددًا، بدل إنشاء Route منفصل لكل معرف.
إنشاء مسار يحتوي على Parameter
في KERLION API Mock Studio يمكنك تعريف:
GET /api/users/:id
بحيث يمثل :id متغيرًا في مسار الطلب.
اختبار مطابقة المسار مع طلب فعلي
إذا كان لديك التعريف السابق، فإن طلبًا مثل:
GET /api/users/123
يمكن أن يطابق هذا المسار.
وكذلك ينطبق النمط على قيمة أخرى مثل:
GET /api/users/456
![]() |
| يوضح المثال أن تعريف /api/users/:id يمكن أن يطابق طلبات تستخدم قيما مختلفة لمقطع id مثل 123 و456. |
لأن الجزء :id يمثل مقطعًا واحدًا غير فارغ في المسار.
المهم هنا أن المشروع يستخدم Path Parameter في مطابقة Route، وليس لتحويل القيمة تلقائيًا إلى متغير داخل JSON Response.
حدود مطابقة المسارات
يجب الانتباه إلى أن Query Strings وURL Fragments ليست جزءا من تعريفات Route في الإصدار الحالي.
لذلك ينبغي بناء تعريفات المسارات وفق صيغة Route التي يدعمها المشروع، وعدم افتراض أن جميع عناصر URL يمكن استخدامها في المطابقة بالطريقة نفسها.
كيفية إضافة Response Headers والتحقق منها
لا تقتصر الاستجابة على Status Code وBody، فقد تحتاج أيضًا إلى تعريف Response Headers.
ما المقصود بـ Response Headers؟
Response Headers هي بيانات تصف جوانب من استجابة HTTP، مثل نوع المحتوى.
ومن الأمثلة الشائعة:
Content-Type: application/json
إضافة Response Headers إلى Endpoint
يمكنك إضافة Response Headers إلى تعريف Endpoint عندما تحتاج إلى تضمينها ضمن الاستجابة التي تحاكيها مساحة العمل.
مثال:
Content-Type: application/json
وهذا يجعل تعريف الاستجابة أقرب إلى الشكل المتوقع من REST API حقيقي، دون أن يعني ذلك أن المشروع يرسل هذه الترويسات عبر HTTP Server فعلي.
التحقق من صحة الترويسات
يتضمن المشروع آليات للتحقق من بيانات Response Headers وتنظيف البيانات غير المكتملة عند الحفظ والتصدير.
ومن التفاصيل المهمة أن صفوف الترويسات غير المكتملة لا يتم الاحتفاظ بها ضمن Workspace المحفوظ أو المصدر عند التصدير إلى أن تحتوي على اسم Header صالح.
وبالتالي، لا ينبغي التعامل مع هذه الوظيفة على أنها اختبار شبكي لرؤوس HTTP؛ فهي جزء من التحقق من إعدادات Workspace نفسها.
كيفية اختبار Mock API باستخدام Local Playground
بعد تعريف Endpoint، تأتي خطوة اختبار كيفية مطابقة الطلب مع التعريف.
إعداد الطلب التجريبي
من خلال Local Playground يمكنك إعداد الطلب الذي تريد اختباره، مثل:
GET /api/users
أو:
GET /api/users/123
ثم استخدام Send request للتحقق من كيفية تعامل المشروع مع الطلب وفق تعريفات المسارات الموجودة.
اختبار Request Matching
![]() |
| توضح الواجهة كيف يستخدم المطور Local Playground لإرسال Request تجريبي والتحقق من مطابقته لتعريف Endpoint ثم رؤية الاستجابة الثابتة التي أعدها مسبقًا. |
يعتمد الاختبار على مقارنة خصائص الطلب مع تعريفات Endpoints.
فعلى سبيل المثال، إذا عرّفت:
GET /api/users
فإن طلبًا يستخدم Method مختلفة لا يمثل التعريف نفسه.
وبالمثل، إذا كان لديك:
GET /api/users/:id
فإن المسار الذي يحتوي على قيمة لمقطع id يمكن أن يطابق تعريف المسار وفق قواعد المطابقة التي يدعمها المشروع.
بهذه الطريقة تستطيع اكتشاف ما إذا كان Route الذي أعددته يمثل شكل الطلب المتوقع قبل الاعتماد على Backend حقيقي.
فهم نتيجة الاختبار
عندما يجد المشروع تعريف Route مطابقًا، يعرض الاستجابة الثابتة التي أعددتها لذلك Endpoint.
وهنا يجب التفريق بين اختبار المطابقة وبين تنفيذ API فعلي. المشروع لا يرسل الطلب إلى خادم، ولا يشغّل منطق Backend، ولا ينفذ استعلامًا على قاعدة بيانات.
إذا لم يتطابق الطلب مع تعريف موجود، فلن تحصل على سلوك API حقيقي من خادم خارجي؛ لأن Local Playground يعمل ضمن نطاق المحاكاة المحلية للمشروع.
اختبار Request Body
يدعم المشروع التحقق من صياغة Request Body، وهو أمر مفيد عندما تريد التأكد من أن JSON الذي يحاكيه الطلب مكتوب بصيغة صحيحة.
لكن هذا التحقق لا يعني أن محتوى الطلب يُستخدم لتنفيذ منطق Backend.
فمثلًا، إذا أرسلت Request Body تحتوي على:
{
"name": "Ahmed"
}
فلا يعني ذلك أن المشروع سيأخذ قيمة name ويستخدمها تلقائيًا في Response.
الاستجابة التي يعرضها Endpoint تظل هي الاستجابة الثابتة التي تم تعريفها مسبقًا.
وهذا الفرق مهم جدًا: Syntax Checking للـRequest Body ليس Dynamic Response Generation.
كيفية حفظ واستيراد وتصدير إعدادات Mock API
من مزايا المشروع أنه لا يقتصر على إنشاء Endpoint مؤقت ثم فقد إعداداته عند الانتهاء من جلسة العمل. فالإصدار v1.0.1 يتضمن حفظًا تلقائيًا لمساحة العمل في المتصفح، إضافة إلى Import وExport.
الحفظ التلقائي باستخدام Local Storage
يحفظ المشروع تغييرات Workspace محليًا باستخدام Local Storage.
وهذا يعني أن تعريفات Endpoints والاستجابات والإعدادات التي تحفظها تكون مرتبطة ببيئة المتصفح المحلية المستخدمة.
ولا يتم إرسال بيانات Workspace إلى خادم KERLION أو إلى API خارجي خاص بالمشروع.
لذلك إذا أردت نقل مساحة العمل إلى جهاز أو متصفح آخر، فلا ينبغي الاعتماد على Local Storage وحده؛ استخدم Export للحصول على ملف Workspace ثم Import في البيئة الأخرى.
![]() |
| يوضح المخطط أن Workspace المحفوظ في Local Storage مرتبط بالمتصفح المحلي، وأن نقل الإعدادات إلى بيئة أخرى يتم عبر تصدير ملف JSON ثم استيراده. |
تصدير Workspace بصيغة JSON
يوفر المشروع خيار Export لتنزيل نسخة قابلة للنقل من Workspace بصيغة JSON.
وهذا مفيد عندما تريد:
- الاحتفاظ بنسخة احتياطية من إعدادات Mock API.
- مشاركة تعريفات Workspace مع عضو آخر في المشروع.
- نقل إعدادات Mock API إلى بيئة أخرى.
- الاحتفاظ بنسخة من إعدادات المشروع خارج المتصفح.
يتم إنشاء ملف التصدير عندما تختار عملية Export، وليس من خلال مزامنة تلقائية مع خادم خارجي.
استيراد Workspace واستعادة الإعدادات
يمكنك أيضًا استيراد Workspace محفوظ مسبقًا.
ولا يتعامل المشروع مع ملف JSON على أنه بيانات عشوائية؛ إذ يتحقق المستورد من بنية الملف ومن عناصر مهمة مثل Methods والمسارات وحالات الاستجابة وقيم Response Headers.
كما أن ملفات الاستيراد محدودة بـ 200 Endpoint في عملية الاستيراد.
فهم بنية Workspace JSON
يمكن أن يكون ملف Workspace المصدّر على هيئة بنية مشابهة للتالية:
{
"format": "kerlion-api-mock-studio",
"version": 1,
"endpoints": [
{
"id": "users-list",
"name": "List users",
"method": "GET",
"path": "/api/users",
"status": 200,
"body": {
"data": []
},
"headers": [
{
"name": "Content-Type",
"value": "application/json"
}
]
}
]
}
توضح هذه البنية العناصر الأساسية التي يحتاجها المشروع لإعادة بناء Workspace، مثل اسم Endpoint والطريقة والمسار وحالة الاستجابة وBody والترويسات.
وتفيد معرفة هذا الشكل عند التعامل مع ملفات Workspace أو نقلها بين بيئات مختلفة، مع الالتزام بالبنية التي يتوقعها المشروع بدل تعديلها عشوائيًا.
حالات استخدام KERLION API Mock Studio في تطوير التطبيقات
لا تحتاج كل مشاريع تطوير الويب إلى Mock API بالطريقة نفسها. وتكون قيمة KERLION API Mock Studio أكبر عندما تكون المشكلة الأساسية هي الحاجة إلى إعداد استجابات ومسارات تجريبية قبل جاهزية Backend.
تطوير Frontend قبل جاهزية Backend
إذا كان فريق Frontend يعمل بالتوازي مع فريق Backend أثناء تطوير التطبيقات، فقد تحتاج الواجهة إلى بيانات لا يستطيع Backend توفيرها بعد.
يمكنك في هذه الحالة تعريف Endpoint مثل:
GET /api/users
وإعداد JSON Response تمثل البنية المتوقعة للبيانات.
يتيح ذلك مواصلة بناء مكونات الواجهة واختبار عرض البيانات دون انتظار اكتمال Endpoint الحقيقي.
اختبار صفحات عرض البيانات
يمكن إعداد استجابات تجريبية لصفحات تعرض مجموعات من البيانات.
على سبيل المثال:
GET /api/products
مع Response Body تحتوي على مجموعة منتجات.
يمكن بعد ذلك استخدام الاستجابة لاختبار عناصر الواجهة التي تعتمد على بنية JSON، مثل القوائم وبطاقات المنتجات ومناطق عرض البيانات.
اختبار حالات HTTP المختلفة
لا يقتصر اختبار Frontend على حالة النجاح فقط.
يمكن إعداد Endpoint بحالة:
200
ثم إعداد سيناريو آخر يمثل خطأ مثل:
404
أو:
500
وبذلك تستطيع التحقق من كيفية تعامل الواجهة مع حالات مختلفة بدل افتراض أن كل طلب سيعود دائمًا باستجابة ناجحة.
اختبار المسارات الديناميكية
عند تطوير واجهة تتعامل مع موارد محددة، قد تحتاج إلى مسارات مثل:
/api/users/:id
وهنا يمكن استخدام Path Parameters لاختبار مطابقة مسارات مثل:
/api/users/123
و:
/api/users/456
مع الحفاظ على فهم صحيح لنطاق المحاكاة: المشروع يختبر مطابقة المسار، ولا ينشئ منطقًا ديناميكيًا يستخرج id ثم يبني Response مختلفة بناءً عليه.
حدود KERLION API Mock Studio: ما الذي لا تستطيع الأداة فعله؟
فهم حدود المشروع لا يقل أهمية عن معرفة وظائفه، لأن استخدام Mock API بطريقة صحيحة يعتمد على معرفة الفرق بين المحاكاة وبين تشغيل Backend حقيقي.
| ما توفره الأداة | ما لا توفره |
|---|---|
| تعريف REST-style Endpoints | تشغيل HTTP Server حقيقي |
| اختبار Request Matching داخل المتصفح | إنشاء Public API URL |
| إعداد JSON Response ثابتة | إنشاء Dynamic Responses اعتمادًا على Request Body |
| استخدام Path Parameters في مطابقة المسارات | تنفيذ Backend Logic |
| تحديد HTTP Status Codes | تنفيذ CRUD حقيقي على قاعدة بيانات |
| إعداد Response Headers | إرسال استجابات إلى تطبيق خارجي عبر Network API |
| حفظ Workspace محليًا | مزامنة Workspace مع خادم KERLION |
| Import / Export بصيغة JSON | توفير Backend أو Database |
متى تحتاج إلى Backend أو Mock Server حقيقي؟
إذا كان هدفك هو تشغيل تطبيق Frontend فعليًا وإرسال طلبات HTTP من ذلك التطبيق إلى عنوان API، فلن تكون المحاكاة المحلية داخل KERLION API Mock Studio كافية وحدها.
ستحتاج في هذه الحالة إلى بيئة توفر HTTP Server أو Mock Server يمكن للتطبيق الوصول إليه عبر الشبكة.
وبالمثل، إذا كان الاختبار يتطلب:
- تنفيذ منطق Backend.
- معالجة بيانات الطلب فعليا.
- إنشاء استجابات ديناميكية.
- تخزين البيانات.
- تنفيذ عمليات CRUD.
- اختبار اتصال شبكي حقيقي بين Frontend وAPI.
فستحتاج إلى نظام آخر يوفر هذه الوظائف.
أما إذا كان هدفك هو إعداد مسارات واستجابات تجريبية واختبار مطابقة الطلبات داخل المتصفح أثناء تطوير الواجهة، فإن KERLION API Mock Studio تناسب هذا السيناريو بصورة مباشرة.
الأسئلة الشائعة حول KERLION API Mock Studio
هل يمكن استخدام KERLION API Mock Studio لاختبار تطبيق Frontend يعمل من مشروع آخر؟
يعتمد ذلك على نوع الاختبار المقصود. يمكن استخدام Local Playground داخل KERLION API Mock Studio لاختبار مطابقة الطلبات مع تعريفات Endpoints، لكن المشروع لا يشغل HTTP Server ولا يوفر Public API Endpoint يمكن لتطبيق Frontend خارجي الاتصال به عبر الشبكة.
لذلك فهو مناسب لمحاكاة تعريفات API واختبارها داخل مساحة العمل، وليس لتوفير API شبكي فعلي لتطبيق آخر.
هل تحتاج الأداة إلى Backend لتشغيلها؟
لا تحتاج الأداة إلى Backend خاص بها لتشغيل المشروع. يمكن تشغيل ملفات المشروع الثابتة مباشرة من خلال متصفح حديث، أو تقديم المجلد باستخدام Static Web Server.
لكن هذا لا يعني أن المشروع نفسه أصبح Backend أو HTTP Server؛ فهو يظل بيئة محاكاة واختبار تعمل ضمن المتصفح.
هل يمكن إنشاء أكثر من Mock Endpoint داخل مساحة عمل واحدة؟
نعم، يمكن إدارة عدة تعريفات Endpoints داخل Workspace واحد، مع إمكانات الإنشاء والتعديل والبحث والحذف.
وعند استيراد Workspace، يفرض المشروع حدًا يصل إلى 200 Endpoint في عملية الاستيراد.
هل تستخرج الأداة قيمة Path Parameter وتستخدمها تلقائيًا داخل JSON Response؟
لا ينبغي التعامل مع Path Parameter بهذه الطريقة.
يمكن للمشروع استخدام نمط مثل:
/api/users/:id
لمطابقة طلب مثل:
/api/users/123
لكن هذا لا يعني أن قيمة 123 تُستخرج تلقائيًا وتُستخدم داخل Response Body لإنشاء استجابة ديناميكية. الاستجابة تظل هي المحتوى الثابت الذي أعددته للـEndpoint.
هل يمكن محاكاة استجابات مختلفة بناءً على بيانات POST أو Request Body؟
لا يوفر المشروع هذا النوع من Dynamic Response Generation.
يمكن التحقق من صحة صياغة Request Body، لكن محتوى الطلب لا يُستخدم لتنفيذ منطق Backend أو تعديل الاستجابة تلقائيًا.
إذا كنت تحتاج إلى منطق يعتمد على بيانات الطلب لتوليد استجابة مختلفة، فستحتاج إلى Backend أو Mock Server يوفر هذه الإمكانية.
ماذا يحدث لإعدادات Mock API عند فتح الأداة من متصفح أو جهاز آخر؟
يتم حفظ Workspace محليًا باستخدام Local Storage في المتصفح المستخدم. لذلك لا ينبغي افتراض أن الإعدادات ستظهر تلقائيًا على جهاز أو متصفح آخر.
لنقل Workspace، يمكنك استخدام Export لإنشاء ملف JSON ثم استخدام Import لاستعادته في البيئة الأخرى.
هل يمكن الاعتماد على KERLION API Mock Studio بدلًا من Mock Server أو أدوات API Testing؟
ليس باعتبارها بديلا شاملا.
KERLION API Mock Studio تركز على تعريف REST-style Endpoints، وإعداد استجابات JSON، واختبار مطابقة الطلبات داخل المتصفح، وحفظ واستيراد وتصدير Workspace.
أما Mock Server الحقيقي فيمكن أن يوفر HTTP Endpoints قابلة للوصول عبر الشبكة، بينما قد توفر أدوات API Testing إمكانات أوسع لاختبار الطلبات والخدمات. لذلك يعتمد الاختيار على نوع الاختبار المطلوب.
الخلاصة: متى تستخدم KERLION API Mock Studio في مشروعك؟
إذا كنت تطور Frontend بينما لا يزال Backend قيد التنفيذ، فقد تحتاج إلى طريقة بسيطة لتعريف شكل API المتوقع وتجربة الاستجابات التي ستتعامل معها الواجهة.
يوفر KERLION API Mock Studio لهذا الغرض مساحة عمل تعمل داخل المتصفح، يمكنك من خلالها إنشاء Mock Endpoints، واختيار HTTP Methods، وتحديد Status Codes، وإنشاء JSON Responses، وإضافة Response Headers، واختبار Request Matching، بما في ذلك المسارات التي تستخدم Path Parameters.
كما يحفظ المشروع Workspace محليًا باستخدام Local Storage، ويوفر Import وExport لنقل إعدادات Mock API بصيغة JSON.
في المقابل، يجب استخدام المشروع ضمن نطاقه الصحيح. فهو لا يشغل HTTP Server، ولا ينشئ Public API Endpoint، ولا يوفر API يمكن لتطبيق خارجي الاتصال به عبر الشبكة، ولا ينفذ Backend Logic أو CRUD حقيقيًا، ولا ينشئ Dynamic Responses اعتمادًا على Request Body.
لذلك يكون KERLION API Mock Studio مناسبًا عندما تحتاج إلى محاكاة REST API واختبار مطابقة الطلبات داخل المتصفح أثناء تطوير التطبيق، بينما تحتاج إلى Backend أو Mock Server حقيقي عندما يتطلب مشروعك اتصالًا شبكيًا فعليًا أو معالجة ديناميكية للطلبات.
يمكنك الاطلاع على الكود والمكونات والوثائق من المستودع الرسمي لـ KERLION API Mock Studio على GitHub، كما يمكنك مراجعة صفحة الإصدار v1.0.1 أو تنزيل الإصدار v1.0.1 مباشرة بصيغة ZIP والبدء في استخدام المشروع ضمن بيئة التطوير المناسبة.
اختبار KERLION API Mock Studio
يقيس هذا الاختبار مدى فهمك لمفهوم Mock API، وقدرتك على تطبيق وظائف KERLION API Mock Studio وتحليل حدود استخدامها في تطوير التطبيقات.
فهم نطاق الأداة
ما الوصف الأدق لطبيعة KERLION API Mock Studio وفقا للمقال؟
مطابقة Path Parameter
أنشأ مطور Endpoint بالتعريف GET /api/users/:id ويريد اختبار طلب للوصول إلى مستخدم ذي معرف 123. أي طلب يطابق هذا التعريف وفقا للمقال؟
اختيار الحل المناسب
فريق Frontend يريد اختبار واجهة تطبيقه بإرسال طلبات HTTP حقيقية من مشروع منفصل إلى عنوان API عبر الشبكة، مع تنفيذ منطق Backend واستجابات ديناميكية. أي قرار يتوافق مع حدود الأداة المذكورة في المقال؟
مساحة للنقاش: يوفر KERLION API Mock Studio حلاً عمليًا لمواصلة تطوير Frontend قبل اكتمال Backend، عبر محاكاة المسارات والاستجابات واختبار مطابقة الطلبات داخل المتصفح، مع بقاء وظائفه محصورة بالمحاكاة المحلية. فمتى ترى أن Mock API المحلي يكفي، ومتى يصبح Mock Server حقيقيًا ضروريا؟
🌟رأيك يهمنا شاركه معنا في التعليقات.🌟





