انتقل إلى المحتوى

إنشاء واجهة REST API وهمية

أنشئ نقاط نهاية JSON وهمية تحدد لها الطريقة والمسار ورمز الحالة والتأخير والمحتوى، أو بيانات وهمية مولّدة، ويقدّمها خادمنا مع دعم CORS للنماذج الأولية والاختبارات.

استخدم :name للمعامل، مثل /users/:id

جسم الاستجابة
التأخير0 ms

تُستبدل السلاسل النصية مثل "{{fullName}}" أو "{{int(1, 100)}}" عند كل طلب.

عنصر

القيمة 0 تُرجع كائنًا واحدًا

العناصر النائبة (36)
{{id}}
1، 2، 3… الترتيب في القائمة
{{index}}
0، 1، 2… الترتيب بدءًا من الصفر
{{uuid}}
معرّف UUID v4 عشوائي
{{firstName}}
الاسم الأول
{{lastName}}
اسم العائلة
{{fullName}}
الاسم الأول واسم العائلة
{{username}}
اسم مستخدم بأحرف صغيرة
{{email}}
عنوان بريد على example.com
{{phone}}
رقم هاتف (+1 555…)
{{company}}
اسم شركة
{{jobTitle}}
المسمى الوظيفي
{{street}}
عنوان الشارع
{{city}}
المدينة
{{country}}
الدولة
{{countryCode}}
رمز ISO 3166
{{zip}}
رمز بريدي من 5 أرقام
{{domain}}
نطاق تجريبي
{{url}}
رابط https
{{ipv4}}
عنوان IPv4 من النطاق المخصص للتوثيق
{{color}}
لون HEX
{{word}}
كلمة lorem واحدة
{{words}}
words(n): عدد n من كلمات lorem
{{sentence}}
جملة lorem
{{paragraph}}
من ثلاث إلى خمس جمل
{{int}}
int(min, max): عدد صحيح
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): بمنزلتين عشريتين
{{bool}}
true أو false
{{date}}
تاريخ خلال السنة الماضية (YYYY-MM-DD)
{{datetime}}
تاريخ ووقت بصيغة ISO خلال السنة الماضية
{{futureDate}}
تاريخ خلال السنة القادمة
{{status}}
active أو pending أو inactive
{{pick}}
pick(a, b, c): أحد الخيارات
{{param}}
param(name): قيمة من مسار الرابط، مثل :id
{{query}}
query(name): قيمة من سلسلة الاستعلام
{{null}}
القيمة null في JSON
ترويسات الاستجابة (اختيارية، X- فقط)
3 / 10 نقطة نهاية
تُعالج على خادمنا · يُحفظ JSON الخاص بنقطة النهاية إلى أن تحذفه أو تمر 7 أيام دون أي طلبكيف يعمل الموقع

طريقة استخدام واجهة REST API وهمية

  1. 1

    صِف كل نقطة نهاية

    اختر الطريقة، واكتب مسارًا مثل /users/:id ثم حدّد رمز الحالة وتأخيرًا اختياريًا يحاكي شبكة بطيئة.

  2. 2

    اكتب الاستجابة

    الصق JSON ثابتًا، أو انتقل إلى «بيانات وهمية» واكتب قالبًا يحتوي على عناصر نائبة مثل {{fullName}} مع تحديد حجم القائمة.

  3. 3

    أنشئ واجهة API الوهمية

    اضغط «إنشاء واجهة API وهمية» لتحصل على رابط أساسي؛ تجيب كل نقطة نهاية على هذا الرابط متبوعًا بمسارها، مع تفعيل CORS.

  4. 4

    استدعِها وطوّرها

    استخدم «تجربة» أو curl أو fetch من تطبيقك، ثم عدّل واحفظ، فالتغييرات تُطبَّق فورًا، أو احذف الواجهة الوهمية عند الانتهاء.

الحدود وخطة Pro

مجانًا: 10 نقاط نهاية لكل واجهة API وهمية، و100 KB لكل جسم و512 KB إجمالًا، وتأخير حتى 5 ثوانٍ، وقوائم مولَّدة حتى 100 عنصر، و120 طلبًا في الدقيقة لكل زائر، و10 واجهات API وهمية جديدة في الساعة، مع الحذف بعد 7 أيام دون طلبات.

يرفع Pro الحدود إلى 50 نقطة نهاية، وأجسام بحجم 1 MB، وتأخير حتى 30 ثانية، وقوائم من 1,000 عنصر. عرض Pro

عن واجهة REST API وهمية

تمنح أداة Mock REST API مطوّري الواجهات الأمامية وتطبيقات الجوال نقاط نهاية تعمل قبل أن يجهز الخادم الحقيقي. لكل واجهة API وهمية رابط أساسي خاص بها تحت /api/mock-api/m/ ، وكل نقطة نهاية تعرّفها تجيب هناك بالطريقة والمسار ورمز الحالة والتأخير والترويسات وجسم JSON التي اخترتها. يمكن أن تحتوي المسارات على معاملات، فالمسار /users/:id يطابق /users/7 ، ويستطيع القالب أن يعيد تلك القيمة عبر {{param(id)}} أو أن يقرأ سلسلة الاستعلام عبر {{query(name)}} .

يحوّل وضع «بيانات وهمية» قالب JSON إلى استجابات واقعية باستخدام 36 عنصرًا نائبًا، من الأسماء وعناوين البريد الإلكتروني والشركات والمدن إلى معرّفات UUID والتواريخ والأسعار والأرقام ضمن نطاق ونصوص lorem. حدّد حجم القائمة لإرجاع مصفوفة تضم حتى 100 عنصر، وقرّر هل تبقى البيانات نفسها بين الطلبات، وهو ما يناسب اختبارات اللقطات، أم تتغير في كل مرة. تتيح لك رموز الحالة من 200 إلى 599 التدرب على حالات الخطأ مثل 401 و404 و429 و503، ويُظهر تأخير يصل إلى 5 ثوانٍ كيف تتصرف حالات التحميل في تطبيقك.

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

الخصوصية

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

الميزات

نقاط نهاية HTTPS حقيقية

أي طريقة، ومعاملات في المسار، ورموز حالة من 200 إلى 599، وتأخير، وترويسات X- مخصصة.

قوالب بيانات وهمية

أكثر من 30 عنصرًا نائبًا للأشخاص والشركات والأماكن والتواريخ والأرقام والنصوص، في كائن واحد أو قائمة.

آمنة بالتصميم

JSON فقط، مع تفعيل CORS، ودون سجلات للطلبات، ورمز التعديل مخزَّن كتجزئة، والحذف بعد 7 أيام دون استخدام.

واجهة REST API وهمية: الأسئلة الشائعة

ما الذي يُخزَّن على خادمكم وإلى متى؟
نخزّن تعريفات نقاط النهاية التي تحفظها، وتجزئة SHA-256 لرمز التعديل، ووقت إنشاء واجهة API الوهمية ووقت آخر استدعاء لها، وعدد الطلبات التي استقبلتها. لا نسجّل أجسام الطلبات ولا ترويساتها ولا عناوين IP. تُحذف كل واجهة API وهمية عند الضغط على «حذف»، أو تلقائيًا بعد مرور 7 أيام دون أي طلب أو تعديل، فتبقى الواجهة التي تواصل استخدامها متاحة.
هل يمكنني استدعاء واجهة API الوهمية من تطبيق الواجهة الأمامية؟
نعم. تحمل كل استجابة الترويسة Access-Control-Allow-Origin بالقيمة * ، ونجيب طلبات OPTIONS التمهيدية، فيستطيع fetch أو axios أو أي عميل HTTP في المتصفح استدعاءها من أي نطاق، ومنها localhost. استخدم الرابط الأساسي متبوعًا بمسار نقطة النهاية، مثل fetch(base + "/users") . تعمل تطبيقات الجوال و Postman و curl أيضًا، لأن نقاط النهاية روابط HTTPS عادية.
كيف تعمل العناصر النائبة للبيانات الوهمية؟
في وضع «بيانات وهمية»، تُستبدل عند وصول الطلب كل سلسلة نصية في قالب JSON تكون عنصرًا نائبًا، مثل "{{email}}" أو "{{int(1, 100)}}" ، وتتحول العناصر النائبة للأرقام ولقيم true أو false التي تشغل السلسلة كاملة إلى أرقام وقيم منطقية حقيقية في JSON. يمكن أيضًا وضع العناصر النائبة داخل نص، مثل "Hello {{firstName}}" . حدّد حجم القائمة لتكرار القالب، ويعدّ {{id}} بالترتيب 1 ثم 2 ثم 3 لكل عنصر.
هل يمكن أن تُرجع الواجهة الوهمية أخطاء أو استجابات بطيئة؟
نعم. اختر أي رمز حالة من 200 إلى 599، مثل 401 Unauthorized أو 404 Not Found أو 422 لأخطاء التحقق أو 429 Too Many Requests أو 503، واكتب JSON الخطأ الذي يتوقعه تطبيقك. يؤخّر شريط «التأخير» كل استجابة حتى 5 ثوانٍ في الخطة المجانية، وهذا يساعد على اختبار مؤشرات التحميل والمهلات ومنطق إعادة المحاولة. تُرسل استجابات الحالتين 204 و304 دون جسم.
لماذا لا تستطيع واجهة API الوهمية إرجاع HTML أو تعيين ملفات تعريف الارتباط؟
نقاط النهاية المستضافة مجانًا التي تُرجع أي محتوى أداة مفضلة لصفحات التصيد وروابط البرمجيات الخبيثة. لتبقى هذه الواجهات الوهمية صالحة للاستخدام كواجهات API فقط، تكون كل استجابة من نوع application/json مع nosniff وسياسة أمان محتوى مقيّدة، ولا يُسمح إلا بالترويسات المخصصة التي تبدأ بـ X- ، فلا تستطيع الواجهات الوهمية تعيين ملفات تعريف الارتباط ولا إعادة توجيه المتصفحات ولا انتحال صفة صفحة ويب.