Swagger هي أداة خاصة تقوم تلقائيًا بتكوين وثيقة RESTful API .

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

للوصول إلى Swagger ، تحتاج إلى الضغط على زر Preview في التطبيق المنشور والنقر فوق اسم خطة النشر المطلوبة ( Deploy Plan ).

swagger access

في النافذة المفتوحة حديثًا ، يتم عرض قائمة بنقاط النهاية المتاحة والأساليب المرتبطة بنقاط النهاية هذه. تتوفر بعض الطلبات فقط لمجموعات معينة من المستخدمين المصرح لهم (راجع البرامج Middleware Auth module لكل طلب محدد في قسم Endpoints ). Bearer Token مطلوب للطلبات المسموح بها للمستخدمين المصرح لهم فقط.

يمكنك الوصول إلى نقطة النهاية المقابلة مباشرة في Swagger للحصول على هذا الرمز المميز (قسم Auth ، POST /auth ).

swagger authorize

اضغط Try it out وأدخل تسجيل الدخول وكلمة المرور للحصول على رمز مميز.

سيتم إرسال الطلب عند Execute . إذا تم بنجاح ، فسترى حقلاً token بقيمة Bearer token .

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

  1. اضغط على F12 في متصفح الويب الخاص بك لفتح أداة المطور.
  2. أرسل أي طلب في التطبيق المنشور (لتحديث الجداول ، على سبيل المثال). يجب أن يكون المستخدم الذي يرسل هذا الطلب مفوضًا للوصول إلى نقطة النهاية هذه.
  3. افتح علامة تبويب Network وابحث عن الطلب المقابل.
  4. انتقل إلى علامة التبويب " Headers " وابحث عن قسم " Request Headers ". سيتم تقديم Bearer token تحت Authorization .

bearer token

قم بتوفير Bearer token لـ Swagger بالضغط على " Authorize " ولصق القيمة التي نسختها في الخطوة السابقة.

بالنسبة لطلبات الاختبار ، حدد المجموعة المرغوبة والطريقة التي تريد تنفيذها. اضغط Try it out واملأ معاملات إدخال الطلب. انقر فوق Execute لتنفيذ الاستجابة.

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

response 200

  • 401 - لم يتم إكمال الطلب بنجاح لأن رمز التفويض المطلوب مفقود أو غير صالح.

    response 401

  • 404 - تمت معالجة الطلب بنجاح ، ولكن لم يتم العثور على المورد المطلوب.

    response 404

  • 422 - تم تمرير معلمات غير صحيحة إلى إدخال الطلب.

    response 1200

  • 500 - خطأ في معالجة الطلب من قبل الخادم.

    response 500

رفع خطأ مخصص

بالنسبة إلى عمليات BP المخصصة والطلبات ذات الصلة ، من الممكن إنشاء رموز خطأ مخصصة مع الأوصاف باستخدام كتلة Raise Error في محرر BP. مثال على هذه العملية أدناه:

example

في هذه الحالة ، إذا فشل الطلب إلى نقطة النهاية المرتبطة بـ BP أعلاه ، فسيصدر الخادم خطأ 418 يحتوي على نص الخطأ عند تنفيذ قاعدة البيانات DB: Create Candidate block . يمكن أن يكون رمز الخطأ في هذا المثال أي رمز يحدده المستخدم.

ملاحظة: يشير رمز الاستجابة لخطأ عميل إبريق الشاي HTTP 418 إلى أن الخادم يرفض تحضير القهوة لأنه ، بشكل دائم ، إبريق شاي. بدلاً من ذلك ، يجب أن تُرجع إناء القهوة / الشاي المدمج الذي نفد مؤقتًا من القهوة 503. هذا الخطأ هو إشارة إلى Hyper Text Coffee Pot Control Protocol المحدد في نكات كذبة أبريل في عامي 1998 و 2014.

Was this article helpful?

AppMaster.io 101 حلقة دراسية مكثفة

10 وحدات
2 أسابيع

لست متأكدا من أين تبدأ؟ ابدأ في الدورة التدريبية المكثفة للمبتدئين واستكشف AppMaster من الألف إلى الياء.

ابدأ الدورة
Development it’s so easy with AppMaster!

هل تريد المزيد من المساعدة؟

حل أي مشكلة بمساعدة خبرائنا. وفر الوقت وركز على بناء تطبيقاتك.

headphones

اتصل بالدعم

أخبرنا عن مشكلتك ، وسنجد لك حلاً.

message

دردشة المجتمع

ناقش الأسئلة مع مستخدمين آخرين في محادثتنا.

الانضمام إلى المجتمع