كيفية محاكاة واجهة برمجة التطبيقات في دقيقة واحدة

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

في كل مرة أفعل فيها ذلك، أعتقد أنه ليس ما ينبغي على مطور الواجهة الأمامية القيام به.

يجب أن يكون هناك طريقة أفضل لإنجاز ذلك.

لقد جربت العديد من الأدوات. استخدمت Postman كخادم وهمي، ولكن يجب إضافة جميع بيانات الاستجابة يدويًا. جربت faker.js، ولكن يتعين علي كتابة كود وهمي لكل حقل.

في توقعاتي، يجب أن يقوم خادم وهمي ممتاز بتوليد البيانات بنفسه. يجب على المطورين الانتباه إلى الأمور الأساسية الحقيقية.

أخبار رائعة: الآن، يمكنك تخيل واجهة برمجة التطبيقات في دقيقة واحدة فقط. وليس لديك حاجة لكتابة أي نصوص برمجية.

لماذا التخيل

التخيل هو خيار جيد إذا كنت في واحدة من الحالات التالية.

1. تم تصميم واجهة برمجة التطبيقات ولكن لم يتم تطويرها. يحدث هذا عادة في الفرق القابلة للتكيف.
2. واجهات برمجة التطبيقات المحظورة أو المدفوعة. على سبيل المثال، واجهات برمجة التطبيقات البنكية. لا يمكنك الحصول على بيانات حقيقية قبل اكتمال التطوير. لذا تحتاج إلى بيانات وهمية.
3. بيئة غير متصلة بالإنترنت أو شبكة داخلية. تسمح لك البيانات الوهمية بالعمل على جهاز محلي.

لنقم بتخيّله

هناك خطوتان لتخيل واجهة برمجة التطبيقات.

1. استيراد تعريفات واجهة برمجة التطبيقات.
2. الحصول على عنوان URL الوهمي.

سهل جدًا. لنقم بتخيّله!

الخطوة 1 - استيراد تعريفات واجهة برمجة التطبيقات

وثائق واجهة برمجة التطبيقات ضرورية. OpenAPI (Swagger) هو الأفضل، وأي تنسيق آخر مقبول أيضًا.

افترض أن لديك ملف YAML أو JSON. سنقوم باستيراده إلى هذه الأداة: Apidog. إذا لم يكن لديك واجهة برمجة تطبيقات بعد، يمكنك أيضًا إنشاؤها في Apidog.

1.قم بإنشاء مشروع جديد في Apidog.

2.اذهب إلى "الإعدادات" - "استيراد"، وسحب ملف واجهة برمجة التطبيقات الخاص بك.

يتم دعم أكثر من عشرة تنسيقات لوثائق واجهة برمجة التطبيقات. انقر على "التالي" وسيتم استيراد واجهة برمجة التطبيقات الخاصة بك.

الآن سترى واجهات برمجة التطبيقات في Apidog.

الخطوة 2 - الحصول على عنوان URL الوهمي

1.انقر على واجهة برمجة التطبيقات في Apidog. سترى صفحة تعريف واجهة برمجة التطبيقات، تحتوي على قسم يسمى "وهمي".

2.انقر على عنوان URL في جزء "المحاكاة المحلية" الذي يبدأ بـ "127.0.0.1" لنسخه.

3.الصقه في متصفحك.

حسنًا، تم الأمر! سترى JSON وهمي!

حقل "المدينة" مملوء باسم مدينة، وحقل "id" مملوء برقم صحيح، و "createdAt" مملوء بتاريخ ووقت.

الآن يمكنك استخدام بيانات واجهة برمجة التطبيقات في تطبيقك.

ولا تحتاج إلى كتابة أي نصوص برمجية! البيانات في جميع الحقول يتم توليدها تلقائيًا.

علاوة على ذلك، إذا نقرت "تحديث" في المتصفح، ستتحديث البيانات!

مذهل.

كيف يعمل

عندما وجدت هذه الميزة لأول مرة، كنت متفاجئًا جدًا. لماذا يمكن لـ Apidog توليد هذا؟ لم أقم بإعداد أي شيء!

في وقت لاحق وجدت هذا.

هناك مجموعة من القواعد الوهمية المدمجة في Apidog، كما هو موضح أعلاه. إذا كان اسم الحقل لديك في تعريف الاستجابة يتطابق مع أحدها، فسيتم تخييل بيانات الحقل تلقائيًا.

ويقوم Apidog بتشغيل خادم وهمي في جهازك المحلي تلقائيًا. لذا لا تحتاج إلى القيام بأي شيء في طبقة الخادم.

ماذا لو لم تعجبك البيانات التي يتم تخييلها تلقائيًا؟ هذا أيضًا سهل.

يمكنك ملء قيمة وهمية للحقل مباشرة باستخدام Faker.js مثل هذا.

يتم دعم جميع قواعد Faker.js حتى تتمكن من اختيارها بسهولة.

وإذا كان لبعض الحقول قيمة ثابتة، يمكنك أيضًا ملء "الوهم" بالقيمة المحددة.

حسنًا، كل شيء تم.

آمل أن تتخيل بسعادة مع Apidog.

إنه حقًا أداة جيدة. وقد وجدت أنه ليس فقط جيدًا للتخيل، ولكن لكل شيء في تطوير واجهة برمجة التطبيقات.