معمل تسلسل معلمات OpenAPI

قم بمعاينة كيفية تسلسل معلمات مسار OpenAPI والاستعلام والرأس وملفات تعريف الارتباط وفقًا لإعدادات النمط والتقسيم محليًا.

الصق أو اختر مستند OpenAPI 3.0 أو 3.1 أو 3.2، وافحصه، وحدد عملية المسار واضبط كل قيمة معلمة JSON. قم بمعاينة المسار وسلسلة الاستعلام والرؤوس وملفات تعريف الارتباط، ثم انسخ الأجزاء التي تحتاجها.

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

الصق JSON أو YAML أدناه، أو اختر ملفًا.

ما يصل إلى 2 ميجابايت و300 عملية مسار. يدعم OpenAPI 3.0 و3.1 و3.2. لا يتم جلب المراجع الخارجية.

طريقة الاستخدام

تحقق من كيفية ظهور معلمة API على السلك

قم بمعاينة كيفية تسلسل معلمات مسار OpenAPI والاستعلام والرأس وملفات تعريف الارتباط وفقًا لإعدادات النمط والتقسيم محليًا.

خطوات الاستخدام

  1. أدخل المصدر عبر: مواصفات OpenAPI.
  2. نفّذ: فحص المواصفات. افحص النتيجة قبل النسخ أو التنزيل أو الاستخدام في مكان آخر.
  3. اضبط: عملية المسار. استخدم المرجع أدناه لاختيار ما يناسب مهمتك.
  4. نفّذ: معاينة التسلسل. افحص النتيجة قبل النسخ أو التنزيل أو الاستخدام في مكان آخر.
  5. الصق أو اختر مستند OpenAPI 3.0 أو 3.1 أو 3.2، وافحصه، وحدد عملية المسار واضبط كل قيمة معلمة JSON. قم بمعاينة المسار وسلسلة الاستعلام والرؤوس وملفات تعريف الارتباط، ثم انسخ الأجزاء التي تحتاجها.

اختيار الإعدادات

الخيارما الذي يتغير
عملية المساريتم تطبيق نمط OpenAPI وإعدادات التقسيم على معلمات المسار والاستعلام والرأس وملفات تعريف الارتباط. تتضمن الأنماط الشائعة المدعومة: Simple، وlabel، وMatrix، وform، وspaceDelimited، وpipeDelimited، وdeepObject.
معاينة التسلسللا يتم تخمين المعلمات المستندة إلى المحتوى والمصفوفات أو الكائنات المتداخلة ومجموعات الأنماط غير المحددة والمراجع الخارجية. يتم عرض قيم الرأس بدون تشفير URI لأن قواعد نقل الرأس تعتمد على الرأس. لم يتم التحقق من صحة المخطط.

مثال والنتيجة المتوقعة

بالنسبة إلى GET /users/{id}، تصبح صفيف الاستعلام `tag: [api, local]` مع `style: form` و`explode: true` `tag=api&tag=local`. يتم ترميز قيمة المسار العددي قبل إدراجها في المسار. لا تتحقق الأداة من صحة المخطط أو ترسل طلبًا؛ يتم ترك ترميزات المحتوى غير المدعومة والقيم المتداخلة والمراجع الخارجية للمراجعة اليدوية.

إذا لم يعمل

  • لا يتم تخمين المعلمات المستندة إلى المحتوى والمصفوفات أو الكائنات المتداخلة ومجموعات الأنماط غير المحددة والمراجع الخارجية. يتم عرض قيم الرأس بدون تشفير URI لأن قواعد نقل الرأس تعتمد على الرأس. لم يتم التحقق من صحة المخطط.
  • لا. تقوم الأداة فقط بإنشاء معاينة محلية للعملية المحددة. ولا يحل الخوادم أو يضيف مصادقة أو يرسل طلبات الشبكة.
  • إذا فشل التحليل، فتحقق من صياغة JSON أو YAML قبل مراجعة نتائج API. ضع المراجع المحلية اللازمة داخل المستند نفسه. تحتاج المراجع الخارجية والبنى غير المدعومة إلى مراجعة يدوية؛ لا تجلبها الأداة ولا تختبر خادمًا فعليًا.

ما الذي تقوم به هذه الأداة للتسلسل؟

يتم تطبيق نمط OpenAPI وإعدادات التقسيم على معلمات المسار والاستعلام والرأس وملفات تعريف الارتباط. تتضمن الأنماط الشائعة المدعومة: Simple، وlabel، وMatrix، وform، وspaceDelimited، وpipeDelimited، وdeepObject.

ما الذي يحتاج إلى مراجعة يدوية؟

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

هل يستدعي API؟

لا. تقوم الأداة فقط بإنشاء معاينة محلية للعملية المحددة. ولا يحل الخوادم أو يضيف مصادقة أو يرسل طلبات الشبكة.