تخطَّ إلى المحتوى

توليد الأكواد وتصدير مواصفات API

الطلبات الملتقَطة ليست فقط للمشاهدة، بل يمكن أن تتحول مباشرة إلى مخرجات جاهزة: طلب واحد يتحول إلى كود قابل للتشغيل (5 لغات) بنقرة واحدة، وجلسة كاملة تُدمج في مواصفة API (OpenAPI) حقيقية، أو تُصدَّر إلى صيغة التبادل العامة HAR. كل شيء يأتي مباشرة من التقاطات حقيقية: لا نسخ يدوي، ولا كتابة من الصفر. يمكن أيضًا استيراد جلسات مُلتقَطة في مكان آخر وتحليلها هنا.


1. توليد الكود: تحويل طلب واحد إلى كود قابل للتشغيل

Section titled “1. توليد الكود: تحويل طلب واحد إلى كود قابل للتشغيل”

هل التقطت طلبًا تريد إعادة إنتاجه أو مشاركته؟ حوّله إلى كود جاهز للتشغيل بنقرة واحدة، ثم الصقه في طرفية، أو أدرجه في مشروع، أو أرسله إلى زميل.

5 صيغ، بدّل اللغة لإعادة التوليد فورًا، وانسخ بنقرة واحدة:

  • cURL (الصقه في طرفية ليعمل)
  • Python
  • JavaScript
  • Go
  • OkHttp (Java / Kotlin)

الكود المُولَّد كامل: طريقة الطلب، والعنوان (URL)، وكل الترويسات، والجسم. تحافظ الترويسات على ترتيبها الأصلي وأي تكرارات فيها، فتُحفظ ترتيبات وإدخالات مكررة تمامًا، بحيث يطابق ما يعمل الطلب الحقيقي تمامًا، وجاهز للاستخدام كما هو.

توليد الكود: التبديل بين cURL / Python / JavaScript / Go / OkHttp، كامل بالطريقة والترويسات والجسم، نسخ بنقرة واحدة

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

من أين تولّده

  • قائمة الالتقاط: انقر بزر الفأرة الأيمن على أي طلب، ثم “توليد كود…”.
  • المُركِّب: بعد ضبط طلب في التركيب وإعادة الإرسال، انقر على “توليد كود”.

متى تستخدمه: إعادة إنتاج طلب حقيقي مُلتقَط في نص برمجي أو مشروع؛ تصدير طلب كـكود بعد جعله يعمل في المُركِّب، ثم مواصلة التطوير؛ مشاركة طلب واحد مع زميل (يمكن لأي شخص تشغيل سطر cURL).


2. تصدير مواصفة API: تحويل جلسة إلى OpenAPI

Section titled “2. تصدير مواصفة API: تحويل جلسة إلى OpenAPI”

هل التقطت مقطعًا من حركة API وتريد مواصفة حقيقية؟ تنظّم الأداة هذه الطلبات تلقائيًا، وتدمجها في قائمة نقاط نهاية، وتولّد وثيقة OpenAPI بنقرة واحدة، دون كتابة يدوية.

  • التحليل أولًا، ثم التصدير: تكتشف تلقائيًا نقاط النهاية من الجلسة الحالية وتسردها لتتحقق منها، بحيث تصدّر فقط ما تختاره وتتجنب الضجيج. تعرض القائمة لكل نقطة نهاية طريقتها، ومسارها، وعدد مرات ظهورها، ورموز الحالة المُلاحَظة مباشرة، فتمنحك صورة واضحة بنظرة واحدة.
  • دمج المسارات تلقائيًا: تُقولب المسارات ذات المعرفات الملموسة، فمثلًا يصبح /users/123 هو /users/{id}، بدمج طلبات متعددة إلى نقطة النهاية نفسها في واحدة.
  • استنتاج البنية تلقائيًا: تدمج بنية JSON للطلبات/الاستجابات، وتُجمّع الاستجابات حسب رمز الحالة، وتنظّم متغيرات المسار في معاملات (parameters).
  • تنتج مواصفة OpenAPI 3.0 قياسية: انسخها أو نزّلها، ثم استوردها في أي أداة متوافقة مع OpenAPI لمواصلة العمل.

تصدير OpenAPI: تحقق من نقاط النهاية على اليسار (الطريقة / المسار / عدد مرات الظهور / رموز الحالة)، معاينة حية لمواصفة OpenAPI 3.0 المُستنتَجة تلقائيًا على اليمين

متى تستخدمه: بعد التقاط حركة API، أنتج بسرعة مخرجًا جاهزًا وقابلًا للاستيراد بصيغة OpenAPI؛ أعمال التحليل، أو التكامل مع واجهات برمجة تطبيقات جهات خارجية، أو ملء التوثيق لفريق الواجهة الخلفية، أو بناء حالات اختبار لفريق ضمان الجودة.


3. الاستيراد والتصدير: التفاعل مع أدوات أخرى

Section titled “3. الاستيراد والتصدير: التفاعل مع أدوات أخرى”

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

  • تصدير HAR: صدّر التقاطًا كاملًا إلى ملف HAR 1.2 قياسي بنقرة واحدة، للتسليم أو الأرشفة أو تسليمه لأداة أخرى لمزيد من التحليل.
  • استيراد جلسات التقطها آخرون: استورد ملفات جلسات التقاط خارجية (HAR 1.2، و.pcap / .pcapng، وملفات الجلسات المُصدَّرة من أدوات الالتقاط الشائعة)، بحيث يمكن سحب حزم التقطها شخص آخر لمشاهدتها ومقارنتها وتصديرها.

متى تستخدمه: أدخل حركة مُلتقَطة في الإنتاج، أو من زميل، أو من أدوات أخرى، وواصل تحليلها هنا مع أدوات فك الترميز، وملفات تعريف المضيف، ومقارنة الطلبات؛ أو صدّر مقطعًا من حركة مُلتقَطة هنا إلى صيغة عامة للتسليم.


العودة إلى التقاط عبر البروكسي · ذو صلة: التركيب وإعادة الإرسال · الفحص وفك الترميز