غيّر طريقة توثيق واختبار وعرض واجهات برمجة التطبيقات (APIs) الخاصة بك باستخدام هذه الأداة المجانية الرائعة!
هل تمنيت يومًا وجود أداة يمكنها التعامل مع سير عمل واجهة برمجة التطبيقات (API) بالكامل - بدءًا من تصميم API والمحاكاة والاختبار وتصحيح الأخطاء وصولاً إلى التوثيق - كل ذلك في مكان واحد؟ اليوم سأعرض لكم Apidog، البديل المذهل لـ Postman الذي يغير تمامًا طريقة عمل المطورين مع واجهات برمجة التطبيقات.
شاهد الشرح التعليمي الكامل حول Apidog
إليك الفكرة الأساسية — أو النص — الذي ستراه في هذا الفيديو:
ما الذي يجعل Apidog مميزًا؟
لقد قمت بالفعل بتهيئة جميع نقاط النهاية لتطبيقي، وقمت بإنشاء توثيق مباشر عبر الإنترنت لمشروعي متاح الآن لفريقي لاستخدامه. علاوة على ذلك، يمكنني تصدير كل شيء بتنسيق Swagger وOpenAPI والمزيد.
ولكن هنا يكمن عامل التغيير: قبل أن أبدأ في البرمجة، قمت بتصميم نقاط النهاية التي تقدم بيانات الاختبار وقمت بتهيئة ما ستقوم بإرجاعه. هذا يعني أن الفرق يمكنها العمل بالتوازي دون إبطاء بعضها البعض.
قمت أيضًا بإنشاء اختبارات شاملة على كل نقطة نهاية للتحقق من صحة واجهة برمجة التطبيقات (API) الخاصة بي من منظور المستخدم، مما يضمن أنه إذا قام شخص ما بتعطيل واجهة برمجة التطبيقات، فسأُخطَر فورًا.
أوه، وكل هذا مجاني تمامًا. ستغير هذه الأداة طريقة توثيقك والتحقق من صحة واجهات برمجة التطبيقات الخاصة بك وعرضها.
لماذا يتفوق Apidog على Postman
Apidog هو شريكنا الأحدث، وهو بديل متفوق للغاية لـ Postman. بينما يتشابه Apidog مع Postman من حيث اختبار وتوثيق واجهة برمجة التطبيقات، إلا أنه يقدم الكثير:
المزايا الرئيسية:
على عكس Postman، يتيح Apidog للمستخدمين إنشاء وإدارة وتصحيح أخطاء واجهات برمجة التطبيقات ضمن نفس الأداة من البداية.
يركز Apidog على التعاون في الوقت الفعلي، خاصة أثناء عملية تصميم API، مع ميزات متكاملة للتحكم في الإصدارات وإدارة المواصفات.
تصميم API مرئي
يمكنك تصميم واجهات برمجة التطبيقات بصريًا وإنشاء التوثيق تلقائيًا من خلال الجمع بين التصميم والاختبار في تجربة واحدة.
خوادم وهمية ذكية
إليك الميزة الإضافية: يقوم Apidog بإنشاء ما نسميه خادمًا وهميًا. أثناء مرحلة التصميم، تحدد كيفية إرجاع واجهة برمجة التطبيقات للبيانات، وتنشئ رابطًا قابلاً للمشاركة، ويمكن للفرق الأخرى البدء في العمل باستخدام بيانات الاختبار هذه حتى تصبح واجهة برمجة التطبيقات الحقيقية جاهزة. وبهذه الطريقة، لا يعيق فريق عمل فريقًا آخر.
دورة حياة API كاملة
يركز Apidog على تحسين دورة حياة API الكاملة بتصميم وتجربة مستخدم مذهلين.
المشروع التجريبي: واجهة برمجة تطبيقات (API) حقيقية باستخدام Node.js
لإظهار قوة Apidog، قمت بإنشاء مشروع نموذجي على GitHub يمكنك استنساخه والمتابعة معه. إنها واجهة برمجة تطبيقات كاملة مبنية باستخدام:
- Node.js باستخدام Fastify كمكتبة API
- MongoDB كقاعدة بيانات
- محرك اختبار Node.js الأصلي لتغطية اختبار شاملة
في هذا الشرح التعليمي، سأوضح لك كيفية استخدام Apidog لـ:
✅ تشغيل الطلبات مقابل API
✅ إنشاء نصوص برمجية لحفظ البيانات بعد تنفيذ الطلبات
✅ تقسيم واجهات برمجة التطبيقات بين بيئات الإنتاج والتطوير
✅ إنشاء خوادم وهمية ببيانات اختبار
✅ توثيق كل نقطة نهاية باحترافية
✅ نشر التوثيق على الويب
✅ إنشاء سيناريوهات اختبار من منظور متخصص في ضمان الجودة باستخدام Low-code
✅ الحصول على نظرة عامة كاملة على قدرات الأداة
وسأعرض لكم كل هذا باستخدام الخطة المجانية فقط لتفهموا القوة الحقيقية لهذه الأداة.
البدء مع Apidog
الخطوة 1: التنزيل والتثبيت
أولاً، قم بزيارة apidog.com وتصفح الوظائف المذهلة المتاحة. ما أعرضه لكم اليوم هو مجرد غيض من فيض.
انقر على تنزيل واختر نظام التشغيل الخاص بك (Windows أو Mac أو Linux). التثبيت مباشر وسريع.
عند فتح Apidog لأول مرة، سترى واجهة نظيفة مع العديد من المشاريع النموذجية التي توضح لك كيفية العمل مع الأداة، وإجراء الطلبات، وفهم قدراتها.
الخطوة 2: استنساخ المشروع التجريبي
قبل أن نتعمق في Apidog، دعنا نجهز API التجريبي الخاص بنا:
- اذهب إلى مستودع GitHub
- ضع نجمة للمشروع - هذا يساعدنا حقًا!
- انشئ نسخة (Fork) للمستودع في حسابك على GitHub
- استنسخه محليًا لبدء العمل
هيكل المشروع بسيط ومنظم جيدًا. يستخدم:
- Node.js الإصدار 20 (LTS)
- Docker و Docker Compose لـ MongoDB
- تكوين مصحح أخطاء VS Code متضمن
الخطوة 3: تشغيل المشروع
# Start MongoDB with Docker
docker-compose up -d
# Install dependencies
npm ci
# Run tests to verify everything works
npm test
# Start the application
npm startستعمل واجهة برمجة التطبيقات على localhost:3333. يمكنك اختبارها باستخدام أوامر curl المتوفرة لإنشاء العملاء وإدراجهم.
العمل مع Apidog: شرح تعليمي خطوة بخطوة
إنشاء مشروعك الأول

- افتح Apidog وأنشئ مشروعًا جديدًا
2. سمّه "Customers API"
3. اختر لغتك (الإنجليزية، اليابانية، البرتغالية، الإسبانية والمزيد قادم)
4. حدد تنسيق HTTP (نظرًا لأن واجهة برمجة التطبيقات الخاصة بنا تعتمد بالكامل على HTTP)
إعداد البيئات
إحدى الميزات الأساسية هي إدارة البيئات. بدلاً من ترميز عناوين URL الثابتة، سنقوم بإعداد بيئات مختلفة:
- انقر على البيئات (Environments)
- إنشاء بيئة "تطوير (dev)"
- تعيين عنوان URL الأساسي إلى
http://localhost:3333 - استخدم متغيرات مثل
{{baseURL}}في نقاط النهاية الخاصة بك
يتيح لك ذلك التبديل بسهولة بين بيئات التطوير والاختبار والإنتاج.
إنشاء نقطة النهاية الأولى الخاصة بك

دعنا ننشئ نقطة نهاية GET لسرد العملاء:
- أنشئ مجلدًا باسم "Customers"
- داخله، أنشئ مجلدًا فرعيًا "v1" للتحكم في الإصدارات
- أضف نقطة نهاية جديدة:
{{baseURL}}/api/v2/customers - اضبط الطريقة على GET
- انقر على إرسال (Send) للاختبار
يعرض Apidog بيانات API الخاصة بك على الفور، تمامًا مثل أي أداة أخرى عملت معها.
إنشاء مخططات لضمان اتساق البيانات

هنا تكمن روعة Apidog. بدلاً من إنشاء البيانات يدويًا، سنقوم بإنشاء مخططات قابلة لإعادة الاستخدام:
- اذهب إلى المخططات (Schemas) وأنشئ مخططًا جديدًا باسم "Customer"
2. حدد الحقول:
name(سلسلة نصية) - الاسم الكامل للعميلphone(سلسلة نصية) - رقم الهاتف
يمكن الآن إعادة استخدام هذا المخطط عبر جميع نقاط النهاية، مما يضمن الاتساق.
بناء نقطة نهاية POST
لإنشاء العملاء:
- أنشئ نقطة نهاية جديدة باستخدام طريقة POST
2. اضبط عنوان URL على {{baseURL}}/api/v2/customers
3. في قسم الجسد (Body)، حدد JSON
4. أشر إلى مخطط العميل الخاص بك
5. استخدم إنشاء تلقائي (Auto Generate) لإنشاء بيانات عينة
إنشاء بيانات ديناميكية
إليك ميزة قوية: بدلاً من بيانات الاختبار المكتوبة يدويًا، استخدم مولدات البيانات الخاصة بـ Apidog:
- انقر على مولد البيانات (Data Generator) لحقل الاسم
- حدد من الخيارات مثل
{{$randomFirstName}}أو{{$randomFullName}} - افعل الشيء نفسه لرقم الهاتف:
{{$randomPhoneNumber}} - الآن كل طلب ينشئ تلقائيًا بيانات اختبار فريدة وواقعية!
المعالجة اللاحقة واستخراج البيانات
بعد إنشاء عميل، سترغب في استخدام معرف هذا العميل في نقاط نهاية أخرى:
- في نقطة نهاية POST، اذهب إلى المعالجات اللاحقة (Post Processors)
- أضف تأكيدًا (Assertion) للتحقق من وجود المعرف:
$.idموجود - أضف استخراج إلى متغير بيئي (Extract to Environment Variable): احفظ
$.idكـcustomerId

الآن يمكنك استخدام {{customerId}} في نقاط نهاية PUT وDELETE.
إنشاء نقاط نهاية PUT وDELETE
نقطة نهاية PUT (تحديث عميل):
- عنوان URL:
{{baseURL}}/api/v2/customers/{{customerId}} - الأسلوب: PUT
- الجسد: استخدم نفس مخطط العميل
- اخلط البيانات الديناميكية مع البيانات الثابتة لاختبار التحديثات
نقطة نهاية DELETE (حذف عميل):
- عنوان URL:
{{baseURL}}/api/v2/customers/{{customerId}} - الأسلوب: DELETE
- لا يلزم جسد
خادم المحاكاة السحابي
إليك إحدى الميزات القاتلة في Apidog:
- انقر على علامة التبويب المحاكاة (Mock)
- قم بتمكين المحاكاة السحابية (Cloud Mock)
- اختر منطقتك (على سبيل المثال، الولايات المتحدة)
- احصل على عنوان URL قابل للمشاركة
يقوم هذا بإنشاء عنوان URL عام يعيد بيانات وهمية بناءً على مخططاتك. يمكن لفرق الواجهة الأمامية استخدام عنوان URL هذا للتطوير مقابل واجهة برمجة التطبيقات الخاصة بك حتى قبل بنائها!
اختبار خادم المحاكاة
1. قم بإنشاء بيئة "اختبار (testing)"
2. اضبط عنوان URL الأساسي على عنوان URL لخادم المحاكاة الخاص بك
3. أوقف تشغيل خادم API المحلي الخاص بك
4. اختبر نقاط النهاية الخاصة بك - ستقوم الآن بإرجاع بيانات وهمية
يقوم خادم المحاكاة بإرجاع بيانات واقعية مختلفة في كل مرة، بناءً على تعريفات المخطط الخاص بك.
إنشاء توثيق جميل
إنشاء توثيق API
- اذهب إلى مشاركة الوثائق (Share Docs)
- انقر على جديد (New) وسمّه "Customers API"
- حدد البيئات التي سيتم تضمينها (dev، testing، cloud mock)
- قم بتكوين عناوين URL الأساسية لكل بيئة
- انقر على حفظ (Save) ثم فتح (Open)
يقوم Apidog تلقائيًا بإنشاء توثيق جميل وتفاعلي لجميع نقاط النهاية الخاصة بك!
اختبار التوثيق
يتضمن التوثيق المُنشأ ما يلي:
- اختبار تفاعلي - يمكن للمستخدمين تجربة نقاط النهاية مباشرة
- بيئات متعددة - التبديل بين بيئات التطوير والاختبار والإنتاج
- أمثلة التعليمات البرمجية - بلغات برمجة متعددة
- واجهة مستخدم جميلة - مظهر احترافي
خيارات التخصيص
يمكنك تخصيص توثيقك:
- نطاقات مخصصة - استخدم نطاقك الخاص
- حماية بكلمة مرور - وصول آمن
- شعارات وعلامات تجارية مخصصة - لتتناسب مع أسلوب شركتك
- عام أو خاص - التحكم في مستويات الوصول
خيارات التصدير
قم بتصدير توثيق API الخاص بك بتنسيقات مختلفة:
- تنسيق OpenAPI/Swagger
- HTML للاستضافة الذاتية
- Markdown لمواقع التوثيق
- مجموعات Postman
ميزات الاختبار المتقدمة
إنشاء سيناريوهات الاختبار
يتضمن Apidog قدرات اختبار قوية:
1. اذهب إلى قسم الاختبار (Test)
2. أنشئ سيناريو اختبار جديد: "Customer List"
3. اضبط مستويات الأولوية (حرجة، عالية، متوسطة، منخفضة)
4. أضف علامات للتنظيم
حالات الاختبار والتحقق من الصحة
إنشاء حالات اختبار لسيناريوهات مختلفة:
1. حالات النجاح - سلوك API الطبيعي
2. حالات الفشل - معالجة الأخطاء (مثل الحقول الإلزامية المفقودة)
3. الحالات الحدودية - شروط الحدود
لكل حالة اختبار:
- تحديد رموز الاستجابة المتوقعة
- إعداد التأكيدات
- استخراج تعريفات الاستجابة لإعادة الاستخدام
تكامل CI/CD
يمكن لـ Apidog الاندماج مع خط أنابيب CI/CD الخاص بك:
- تكامل GitHub Actions
- تنفيذ الاختبار التلقائي
- اختبار الأداء مع عدة مستخدمين متزامنين
- تشغيل الاختبارات المجدولة
هذا يخلق شبكة أمان ثانوية تتجاوز اختبارات تطبيقك.
لماذا Apidog يغير قواعد اللعبة
لفرق التطوير
- نهج التصميم أولاً: صمم عقود API الخاصة بك قبل كتابة التعليمات البرمجية، مما يضمن تخطيطًا أفضل وتوافقًا للفريق.
- التطوير المتوازي: يمكن لفرق الواجهة الأمامية والخلفية العمل في وقت واحد باستخدام خوادم المحاكاة.
- التوثيق التلقائي: يبقى التوثيق متزامنًا مع API الخاص بك تلقائيًا.
لفرق ضمان الجودة (QA)
- إنشاء اختبار مرئي: أنشئ سيناريوهات اختبار معقدة دون كتابة تعليمات برمجية.
- تغطية شاملة: اختبر الحالات الإيجابية والسلبية والحدودية بسهولة.
- اختبار التكامل: تحقق من صحة سير عمل API بالكامل، وليس فقط نقاط النهاية الفردية.
لفرق DevOps
- إدارة البيئات: إدارة بيئات النشر المختلفة بسهولة.
- تكامل CI/CD: الاختبار التلقائي كجزء من خط أنابيب النشر الخاص بك.
- المراقبة: يتم إعلامك عند تعطل واجهات برمجة التطبيقات أو سلوكها غير المتوقع.
مقارنة: Apidog مقابل Postman
| الميزة | Postman | Apidog |
|---|---|---|
| تصميم API | محدود | أدوات تصميم مرئية كاملة |
| خوادم وهمية | أساسية | ذكية، مستضافة سحابيًا |
| التوثيق | مزامنة يدوية | إنشاء تلقائي |
| التعاون | مساحات عمل جماعية | تعاون في الوقت الفعلي |
| الاختبار | مُشغّل المجموعات | سيناريوهات اختبار متقدمة |
| الخطة المجانية | تشغيلات محدودة | استخدام غير محدود |
| إدارة المخطط | أساسية | متقدمة مع إعادة الاستخدام |
ابدأ اليوم
هل أنت مستعد لإحداث ثورة في سير عمل API الخاص بك؟ إليك ما يجب فعله:
1. قم بتنزيل Apidog
قم بزيارة apidog.com وقم بتنزيل الإصدار المجاني لنظام التشغيل الخاص بك.
2. جرب المشروع التجريبي
استنسخ مستودع GitHub واتبع هذا الشرح التعليمي لترى قدرات Apidog بنفسك.
3. استورد المجموعات الموجودة
إذا كنت تستخدم Postman، يمكنك بسهولة استيراد مجموعاتك الموجودة إلى Apidog.
4. ابدأ بالتوثيق
ابدأ بإنشاء توثيق جميل لواجهات برمجة التطبيقات الموجودة لديك.
5. استكشف الميزات المتقدمة
تبنى تدريجياً خوادم المحاكاة، والاختبار الآلي، وتكامل CI/CD.
أفضل الممارسات للنجاح
1. ابدأ بتصميم المخطط
حدد دائمًا مخططات البيانات الخاصة بك أولاً - فهذا يمكّن جميع ميزات Apidog القوية.
2. استخدم متغيرات البيئة
قم بإعداد إدارة البيئة المناسبة من البداية لسير عمل نشر سلس.
3. استغل خوادم المحاكاة
قم بتمكين التطوير المتوازي عن طريق إعداد خوادم المحاكاة مبكرًا في مشروعك.
4. وثق أثناء البناء
قم بإنشاء التوثيق جنبًا إلى جنب مع تطوير API الخاص بك، وليس كفكرة لاحقة.
5. تطبيق الاختبار الآلي
قم بإعداد سيناريوهات اختبار لاكتشاف الانحدارات وضمان موثوقية API.
فوائد واقعية
توفير الوقت
- تطوير API أسرع بنسبة 50% مع عمل الواجهة الأمامية/الخلفية المتوازي
- التوثيق التلقائي يلغي الصيانة اليدوية
- المخططات القابلة لإعادة الاستخدام تقلل العمل المتكرر
تحسينات الجودة
- هياكل بيانات متسقة عبر جميع نقاط النهاية
- الاختبار الشامل يكتشف المشاكل مبكرًا
- التعاون في الوقت الفعلي يقلل من سوء الفهم
إنتاجية الفريق
- أداة واحدة لدورة حياة API بأكملها
- واجهات مرئية يمكن لغير المطورين الوصول إليها
- سير عمل متكامل يلغي التبديل بين السياقات
الخلاصة: مستقبل تطوير API
يمثل Apidog التطور التالي في أدوات تطوير API. من خلال الجمع بين التصميم والاختبار والتوثيق والتعاون في منصة واحدة، فإنه يزيل الاحتكاك وعدم الكفاءة في استخدام أدوات متعددة غير متصلة.
سواء كنت مطورًا فرديًا أو جزءًا من فريق مؤسسي كبير، يقدم Apidog:
✅ إدارة دورة حياة API كاملة
✅ توثيق جميل وتلقائي
✅ خوادم وهمية قوية للتطوير المتوازي
✅ اختبار وتحقق متقدم
✅ تعاون فريق سلس
✅ كل ذلك مجانًا بحدود سخية
الأداة جاهزة لمساعدتك من مرحلة تصميم API وصولاً إلى النشر للإنتاج، مع تجربة مستخدم لا تصدق سهلة الاستخدام ومليئة بالخيارات لزيادة جودة مشاريعك.
هل أنت مستعد لإحداث ثورة في سير عمل API الخاص بك؟ ابدأ رحلتك مع Apidog الآن واختبر الفرق الذي يمكن أن تحدثه منصة API متكاملة حقًا.
