أبيدوج: منصة تطوير API شاملة

Apidog = Postman + Swagger Editor + Swagger UI + Stoplight + ReadMe + JMeter + SoapUI + Mock

هل سئمت من التوفيق بين أدوات واجهة برمجة التطبيقات (API) المتعددة؟ هل تشعر بالإحباط من قيود أو تسعير Postman؟ دعني أقدم لك Apidog - منصة متكاملة تُحدث ثورة في كيفية قيام الفرق بـ تصميم، محاكاة، اختبار، تصحيح أخطاء و توثيق واجهات برمجة التطبيقات.

شاهد الشرح التعليمي بالفيديو الكامل حول Apidog

أدناه هو المحتوى الرئيسي لهذا الشرح التعليمي بالفيديو.

لماذا تختار الفرق Apidog بدلاً من Postman

يكتسب Apidog شعبية هائلة كبديل مفضل لـ Postman، ولسبب وجيه. إنها ليست مجرد أداة أخرى لاختبار واجهات برمجة التطبيقات - إنها منصة تطوير واجهات برمجة تطبيقات متكاملة تجمع وظائف أدوات متعددة في واجهة واحدة سلسة.

الحل المتكامل

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

• Postman - اختبار وتطوير واجهات برمجة التطبيقات
• Swagger Editor & UI - توثيق واجهات برمجة التطبيقات
• Stoplight - تصميم واجهات برمجة التطبيقات
• ReadMe - استضافة الوثائق
• JMeter & SoapUI - اختبار الأداء والأتمتة
• Mock servers - محاكاة واجهات برمجة التطبيقات

الميزات الرئيسية التي تميز Apidog

1. تطوير واجهات برمجة التطبيقات القائم على التصميم أولاً

يتبنى Apidog نهج التصميم أولاً الحقيقي لتطوير واجهات برمجة التطبيقات. يمكنك:

• تصميم واجهات برمجة التطبيقات بصريًا بواجهة سهلة الاستخدام
• تعريف وإعادة استخدام المخططات عبر مشروعك
• توليد مواصفات واجهة برمجة التطبيقات مباشرة من الطلبات
• التعرف التلقائي على مخططات JSON و XML و SQL

2. إمكانيات تصحيح الأخطاء المتفوقة

بينما يقدم Postman نصوصًا برمجية أساسية قبل وبعد الطلب، يذهب Apidog أبعد من ذلك مع:

• التحقق من الاستجابة مدمج
• الاتصال المباشر بقاعدة البيانات (ميزة كبيرة على Postman)
• تأكيدات مرئية بدون برمجة معقدة
• تسجيل وحدة التحكم وفحص مفصل للطلبات

3. خادم المحاكاة المتقدم

ميزة المحاكاة في Postman أساسية ومحدودة. يوفر Apidog:

• محرك محاكاة ذكي مع توليد بيانات ديناميكية
• خوادم محاكاة مستضافة على السحابة
• نصوص محاكاة قابلة للتخصيص
• خوادم محاكاة مُحسَّنة لاختبار التحميل

4. توثيق واجهات برمجة التطبيقات الغني

قم بإنشاء وثائق واجهة برمجة تطبيقات جميلة وتفاعلية تنافس منصات التوثيق المخصصة:

• دعم النطاق المخصص
• تخطيطات توثيق مخصصة
• دعم صفحات Markdown
• نشر ومشاركة بنقرة واحدة

5. اختبار واجهة برمجة التطبيقات التلقائي مع مصمم بصري

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

البدء مع Apidog

التثبيت والإعداد

البدء بسيط بشكل لا يصدق:

1. زر apidog.com
2. قم بتنزيل عميل سطح المكتب (Windows، Mac، أو Linux) أو استخدم تطبيق الويب
3. أنشئ حسابك المجاني
4. ابدأ البناء!

لا حاجة لبطاقة ائتمان. لا توجد رسوم خفية.

تسعير منطقي

الطبقة المجانية:

• ما يصل إلى 4 متعاونين في الفريق
• 5 مشاريع مختلفة
• عمليات تنفيذ واجهة برمجة تطبيقات غير محدودة
• جميع الميزات الأساسية متضمنة
• Apidog CLI لتكامل CI/CD

الخطط المدفوعة:

• الأساسية: 9 دولارات/مستخدم/شهر - مثالية للفرق الصغيرة
• الاحترافية: ميزات متقدمة للفرق النامية
• المؤسسية: حلول مخصصة للمؤسسات الكبيرة

قارن هذا بتسعير Postman، وستتضح القيمة بشكل لا لبس فيه.

شرح تعليمي عملي: بناء مشروعك الأول لواجهة برمجة التطبيقات

دعني أرشدك خلال إنشاء مشروع واجهة برمجة تطبيقات كامل في Apidog باستخدام GoRest API كمثال.

الخطوة 1: أنشئ مشروعك

1. افتح Apidog وأنشئ فريقًا جديدًا (على سبيل المثال، "Naven Automation Labs")
2. أنشئ مشروع HTTP جديدًا (على سبيل المثال، "GoRest APIs")
3. اختر لغتك المفضلة (الإنجليزية، اليابانية، أو البرتغالية)

الخطوة 2: إعداد بيئتك

تعمل البيئات في Apidog بشكل مشابه لـ Postman ولكن مع ميزات محسنة:

1. انقر على البيئات (Environments) في الشريط الجانبي
2. أنشئ بيئة جديدة (على سبيل المثال، "GoRest Environment")
3. حدد عنوان URL الأساسي الخاص بك: https://gorest.co.in
4. أضف متغيرات مثل رموز المصادقة:

• اسم المتغير: token
• النوع: Secret (للبيانات الحساسة)
• القيمة: رمز حامل واجهة برمجة التطبيقات الخاص بك

الخطوة 3: أنشئ نقطة نهاية واجهة برمجة التطبيقات الأولى الخاصة بك

مثال على طلب GET:

1. انقر على جديد (New) تحت نقاط النهاية (Endpoints)
2. حدد بيئتك (يتم تطبيق عنوان URL الأساسي تلقائيًا)
3. أضف مسار نقطة النهاية الخاصة بك: /public/v2/users
4. انقر على إرسال (Send) للاختبار
5. احفظ باسم ذي معنى: "واجهة برمجة تطبيقات الحصول على المستخدمين"
6. نظم في مجلدات لهيكل أفضل

مثال على طلب POST:

1. أنشئ نقطة نهاية جديدة باستخدام طريقة POST

2. المسار: /public/v2/users

3. أضف ترويسة المصادقة:

• المفتاح: Authorization
• القيمة: حدد المتغير {{token}} الخاص بك من القائمة المنسدلة

4. أضف نص JSON:

{

  "name": "Naven",

  "gender": "male",

  "email": "apidog@gmail.com",

  "status": "active"

}

5. احفظ باسم "إنشاء مستخدم جديد"

الخطوة 4: استخدم المتغيرات الديناميكية

هنا حيث يتألق Apidog. بدلاً من ترميز القيم بشكل ثابت:

1. انقر على إدراج قيمة ديناميكية (Insert Dynamic Value) في أي حقل
2. اختر من مولدات البيانات:

• الإنترنت → البريد الإلكتروني (يولد رسائل بريد إلكتروني عشوائية)
• الأسماء → الاسم الأول، الاسم الأخير
• الأرقام → أعداد صحيحة عشوائية
• التواريخ → تنسيقات تاريخ مختلفة
• وغيرها الكثير!

مثال: {{$internet.email}} يولد تلقائيًا عناوين بريد إلكتروني فريدة لكل طلب.

الخطوة 5: توليد رمز العميل

هل تحتاج إلى تنفيذ استدعاء واجهة برمجة التطبيقات في الكود؟ يولد Apidog كودًا جاهزًا للاستخدام بلغات متعددة:

• cURL (Windows و Linux)
• JavaScript/Node.js
• Python (requests, http.client)
• Java (Unirest)
• Go
• PHP
• Ruby
• C#

والمزيد!

ما عليك سوى النقر على زر Code ونسخ التنفيذ الذي تحتاجه.

ميزات الاختبار المتقدمة

إنشاء سيناريوهات الاختبار

يفصل Apidog تصميم واجهة برمجة التطبيقات عن الاختبار - وهو نهج أنظف من Postman:

• انتقل إلى قسم الاختبار (Test)
• أنشئ سيناريو اختبار جديدًا
• أضف خطوات الاختبار عن طريق الاستيراد من نقاط النهاية الخاصة بك
• حدد الأولوية (P1, P2, P3)
• أضف علامات (على سبيل المثال، "sanity", "regression")

تأكيدات بصرية

هذه ميزة بارزة. بدلاً من كتابة نصوص معقدة، استخدم التأكيدات المرئية:

مثال: التحقق من معرف المستخدم

• مسار الاستجابة: $[0].id
• الشرط: exists (موجود)
• لا يلزم أي برمجة!

مثال: التحقق من صحة اسم المستخدم

• مسار الاستجابة: $.name
• الشرط: equals (يساوي)
• القيمة المتوقعة: Naven

نصوص مخصصة

للمستخدمين المتقدمين، يدعم Apidog نصوصًا مخصصة مماثلة لـ Postman:

// Check status code

pm.test("Status code is 200", function () {

    pm.response.to.have.status(200);

});



// Extract and save data

var jsonData = pm.response.json();

pm.environment.set("bookingId", jsonData.bookingId);

تنفيذ الاختبارات الدفعية

قم بتشغيل سيناريوهات اختبار متعددة معًا:

1. حدد حالات اختبار متعددة

2. انقر على تشغيل دفعة (Batch Run)

3. عرض النتائج الموحدة

4. تصدير تقارير HTML تلقائيًا

لا يوجد حد 25 تشغيلًا مثل Postman!

ميزات التعاون

نظام التفرع

يتضمن Apidog نظام تفرع يشبه Git لتطوير واجهة برمجة التطبيقات:

1. العمل في الفرع الرئيسي (main) لواجهات برمجة التطبيقات المستقرة
2. إنشاء فروع سبرينت (sprint branches) للميزات الجديدة
3. إجراء التغييرات دون التأثير على الفرع الرئيسي
4. دمج (Merge) التغييرات مرة أخرى عندما تكون جاهزة

مثال على سير العمل:

• إنشاء فرع "Sprint 1" من الفرع الرئيسي
• إضافة نقطة نهاية DELETE جديدة
• الاختبار بشكل شامل
• الدمج مرة أخرى مع الفرع الرئيسي
• يرى أعضاء الفريق التحديثات تلقائيًا

التعاون الجماعي

ادعُ أعضاء الفريق بسهولة:

• عبر البريد الإلكتروني أو رابط قابل للمشاركة
• حدد الأذونات: مسؤول، محرر، أو للقراءة فقط
• تعاون في الوقت الفعلي
• بيئات ومجموعات مشتركة

تكامل CI/CD

ادمج اختبارات واجهة برمجة التطبيقات الخاصة بك في أي مسار CI/CD:

1. قم بتوليد رمز الوصول الخاص بك في Apidog
2. قم بتصدير مجموعتك كـ JSON
3. تشغيل من سطر الأوامر:

apidog run collection.json --token YOUR_ACCESS_TOKEN

منصات CI/CD المدعومة:

• Jenkins
• GitLab CI
• GitHub Actions
• CircleCI
• Travis CI
• أي مسار مخصص

جدولة تشغيل الاختبارات

جدولة تنفيذ الاختبارات التلقائي:

• يوميًا، أسبوعيًا، شهريًا، أو كل ساعة
• تكوين وقت محدد
• إشعارات تلقائية
• لا توجد تكلفة إضافية!

الترحيل من Postman

هل أنت قلق بشأن التبديل؟ لا تكن. الترحيل سلس:

استيراد مجموعات Postman إلى Apidog

1. صدر مجموعتك من Postman (تنسيق JSON)
2. صدر متغيرات بيئة Postman الخاصة بك
3. في Apidog، انقر على استيراد (Import)
4. حدد Postman كمصدر
5. اسحب وأفلت ملفاتك
6. انقر على تأكيد (Confirm)

ما يتم استيراده:

• جميع نقاط نهاية واجهة برمجة التطبيقات
• متغيرات البيئة
• نصوص ما قبل الطلب
• نصوص الاختبار
• أمثلة
• هيكل المجلدات

توافق النصوص البرمجية

يحافظ Apidog على التوافق مع نصوص Postman البرمجية القديمة:

• يعمل كائن pm كما هو متوقع
• pm.environment, pm.response, pm.test كلها مدعومة
• لا حاجة لإعادة كتابة نصوصك البرمجية الموجودة!

توثيق واجهة برمجة التطبيقات

نشر التوثيق

قم بإنشاء وثائق واجهة برمجة تطبيقات جميلة وقابلة للمشاركة:

1. انتقل إلى قسم مشاركة (Share)

2. انقر على توثيق جديد (New Documentation)

3. قم بالتكوين:

• العنوان والوصف
• حدد البيئة
• اختر نقاط النهاية لتضمينها

4. انقر على حفظ (Save)

يتوفر التوثيق الخاص بك على الفور مع:

• ميزة "جربها" التفاعلية
• توليد المخطط التلقائي
• تصميم نظيف واحترافي
• دعم النطاق المخصص (الخطط المدفوعة)

إدارة المخطط

حدد مخططات قابلة لإعادة الاستخدام لتحقيق الاتساق:

1. إنشاء مخطط بالحقول (المعرف، الاسم، البريد الإلكتروني، إلخ)
2. تحديد أنواع البيانات (عدد صحيح، سلسلة، منطقي)
3. إضافة أوصاف وتحققات
4. إعادة الاستخدام عبر نقاط نهاية متعددة

الاتصال بقاعدة البيانات

ميزة رئيسية تتفوق بها على Postman - الاتصالات المباشرة بقاعدة البيانات:

قواعد البيانات المدعومة:

• ClickHouse
• MongoDB
• Redis
• MySQL
• PostgreSQL
• والمزيد (في الخطط المدفوعة)

حالات الاستخدام:

• التحقق من صحة البيانات مباشرة في قاعدة البيانات
• إعداد بيانات الاختبار قبل استدعاءات واجهة برمجة التطبيقات
• التنظيف بعد تنفيذ الاختبار
• سيناريوهات التحقق من صحة البيانات المعقدة

أفضل الممارسات

1. إدارة البيئة

• أنشئ بيئات منفصلة للتطوير والاختبار والإنتاج
• استخدم المتغيرات السرية للبيانات الحساسة
• استفد من المتغيرات العامة للقيم المشتركة

2. تنظيم المجلدات

• اجمع نقاط النهاية ذات الصلة في مجلدات
• استخدم أسماء واضحة ووصفيّة
• حافظ على اصطلاحات تسمية متسقة

3. البيانات الديناميكية

• استخدم دائمًا المتغيرات الديناميكية للبيانات الفريدة (رسائل البريد الإلكتروني، المعرفات)
• استفد من مولدات البيانات المضمنة
• تجنب بيانات الاختبار المرمزة بشكل ثابت

4. سيناريوهات الاختبار

• اكتب حالات اختبار ذرية (هدف واحد لكل اختبار)
• استخدم أسماء اختبارات ذات معنى
• أضف علامات لتسهيل التصفية
• نظم في مجموعات اختبار منطقية

5. التوثيق

• حافظ على تحديث التوثيق مع تغييرات واجهة برمجة التطبيقات
• أضف أوصافًا واضحة لجميع نقاط النهاية
• تضمين أمثلة للطلبات والاستجابات
• توثيق متطلبات المصادقة

مقارنة: Apidog مقابل Postman

حالات الاستخدام الواقعية

1. فرق تطوير واجهة برمجة التطبيقات

يضمن نهج التصميم أولاً ما يلي:

• عقود واجهة برمجة تطبيقات واضحة قبل التنفيذ
• تقليل سوء التواصل
• دورات تطوير أسرع
• توثيق أفضل من اليوم الأول

2. مهندسو ضمان الجودة

قدرات اختبار شاملة:

• الاختبار اليدوي والآلي في أداة واحدة
• التأكيدات البصرية تقلل من وقت البرمجة النصية
• تشغيل اختبارات غير محدود للتحقق الشامل
• تكامل سهل مع CI/CD

3. مطورو Full-Stack

كل شيء في مكان واحد:

• تصميم واجهات برمجة التطبيقات
• الاختبار أثناء التطوير
• توليد رمز العميل
• مشاركة التوثيق مع فريق الواجهة الأمامية

4. فرق DevOps

تكامل سلس:

• أداة سطر الأوامر (CLI) لتكامل المسار
• تنفيذ الاختبارات المجدولة
• تقارير آلية
• إدارة البيئة

نصائح وحيل

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

تسريع سير عملك:

• Ctrl/Cmd + S - حفظ الطلب الحالي
• Ctrl/Cmd + Enter - إرسال الطلب
• Ctrl/Cmd + N - طلب جديد

2. الاختبار السريع

استخدم زر إرسال (Send) في أي نقطة نهاية للتحقق السريع قبل الحفظ في سيناريوهات الاختبار.

3. تصور الاستجابة

التبديل بين طرق عرض الاستجابة:

• جميل (Pretty) - JSON/XML منسق
• خام (Raw) - استجابة غير منسقة
• معاينة (Preview) - HTML معروض
• تصور (Visualize) - تصورات مخصصة

4. تتبع السجل

الوصول إلى جميع الطلبات السابقة:

• سجل حسب التاريخ
• سجل مشترك مع الفريق
• إعادة تنفيذ سريعة

5. الإعدادات العامة

قم بالتكوين مرة واحدة، واستخدمه في كل مكان:

• قيم المهلة الافتراضية
• إعدادات شهادة SSL
• تكوين الوكيل (Proxy)
• حدود حجم الطلب/الاستجابة

أسئلة شائعة

س: هل Apidog مجاني حقًا؟

ج: نعم! تتضمن الطبقة المجانية جميع الميزات الأساسية، وعمليات تنفيذ واجهة برمجة تطبيقات غير محدودة، والتعاون لما يصل إلى 4 مستخدمين.

س: هل يمكنني استخدام Apidog دون اتصال بالإنترنت؟

ج: نعم، يعمل عميل سطح المكتب دون اتصال بالإنترنت. تتم المزامنة عند إعادة الاتصال.

س: ما مدى أمان بياناتي؟

ج: يستخدم Apidog تشفيرًا على مستوى المؤسسات. يتم تشفير المتغيرات السرية أثناء التخزين وأثناء النقل.

س: هل يمكنني تصدير بياناتي؟

ج: بالتأكيد. صدر المجموعات بتنسيقات متعددة (OpenAPI، Apidog، Markdown) في أي وقت.

س: هل يدعم GraphQL؟

ج: نعم! يدعم Apidog واجهات برمجة التطبيقات REST و GraphQL و WebSocket.

س: ماذا عن واجهات برمجة تطبيقات SOAP؟

ج: SOAP مدعوم. استورد ملفات WSDL مباشرة.

الخلاصة

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

سواء كنت مطورًا منفردًا، أو مهندس ضمان جودة، أو جزءًا من فريق تطوير كبير، فإن Apidog يقدم:

✓ ميزات قوية تنافس أو تتجاوز Postman

✓ طبقة مجانية سخية بدون قيود اصطناعية

✓ تعاون سلس مع تفرع مدمج

✓ نهج التصميم أولاً الحقيقي لتطوير واجهة برمجة التطبيقات

✓ اختبار غير محدود بدون حدود شهرية

✓ ترحيل سهل من الأدوات الموجودة

الجزء الأفضل؟ يمكنك البدء في استخدامه الآن، مجانًا تمامًا، دون الحاجة إلى بطاقة ائتمان.