Swagger একটি বিশেষ টুল যা স্বয়ংক্রিয়ভাবে আপনার অ্যাপ্লিকেশনের RESTful API নথি রচনা করে।

এর সুবিধাটি এই সত্যের মধ্যে রয়েছে যে এটি আপনাকে কেবল অ্যাপ্লিকেশনটির সমস্ত শেষ পয়েন্টগুলি দেখতে দেয় না, তবে অবিলম্বে একটি অনুরোধ পাঠিয়ে এবং একটি প্রতিক্রিয়া পাওয়ার মাধ্যমে তাদের কার্যকারিতা পরীক্ষা করে।

Swagger অ্যাক্সেস করার জন্য, আপনাকে প্রকাশিত অ্যাপ্লিকেশনে Preview বোতাম টিপুন এবং প্রয়োজনীয় প্রকাশনা পরিকল্পনার নামে ক্লিক করতে হবে ( Deploy Plan )।

swagger access

নতুন খোলা উইন্ডোতে উপলব্ধ এন্ডপয়েন্ট এবং এই শেষ পয়েন্টগুলির সাথে সম্পর্কিত পদ্ধতিগুলির একটি তালিকা দেখানো হয়েছে৷ কিছু অনুরোধ শুধুমাত্র অনুমোদিত ব্যবহারকারীদের নির্দিষ্ট গোষ্ঠীর জন্য উপলব্ধ ( Endpoints বিভাগে প্রতিটি নির্দিষ্ট অনুরোধের জন্য Auth module Middleware দেখুন)। শুধুমাত্র অনুমোদিত ব্যবহারকারীদের জন্য অনুমোদিত অনুরোধের জন্য একটি Bearer Token প্রয়োজন।

আপনি এই টোকেন ( Auth বিভাগ, POST /auth অনুরোধ) পেতে সরাসরি Swagger সংশ্লিষ্ট এন্ডপয়েন্ট অ্যাক্সেস করতে পারেন।

swagger authorize

Try it out ব্যবহার করে দেখুন এবং একটি টোকেন পেতে লগইন এবং পাসওয়ার্ড লিখুন টিপুন।

Execute অনুরোধ পাঠানো হবে। যদি এটি সফলভাবে হয় তবে আপনি Bearer token মান সহ একটি token ক্ষেত্র দেখতে পাবেন।

একটি অনুমোদিত ব্যবহারকারী টোকেন পাওয়ার দ্বিতীয় উপায় হল যে টোকেনটি স্থাপন করা অ্যাপ্লিকেশনটির অনুরোধের অংশে পাওয়া যেতে পারে।

  1. বিকাশকারীর টুল খুলতে আপনার ওয়েব ব্রাউজারে F12 টিপুন।
  2. আপনার নিয়োজিত অ্যাপ্লিকেশনে যেকোনো অনুরোধ পাঠান (উদাহরণস্বরূপ, টেবিল আপডেট করতে)। যে ব্যবহারকারী এই অনুরোধটি পাঠাচ্ছেন তাকে এই শেষ পয়েন্ট অ্যাক্সেস করার জন্য অনুমোদিত হতে হবে।
  3. Network ট্যাব খুলুন এবং সংশ্লিষ্ট অনুরোধটি খুঁজুন।
  4. Headers ট্যাবে যান এবং Request Headers বিভাগ খুঁজুন। Bearer token Authorization অধীনে উপস্থাপন করা হবে।

bearer token

পূর্ববর্তী ধাপে অনুলিপি করা মানটি Authorize এবং পেস্ট করার মাধ্যমে Swagger কে Bearer token প্রদান করুন।

পরীক্ষার অনুরোধের জন্য পছন্দসই গোষ্ঠী এবং আপনি যে পদ্ধতিটি চালাতে চান তা নির্বাচন করুন। Try it out এবং অনুরোধ ইনপুট পরামিতি পূরণ করুন টিপুন। প্রতিক্রিয়া চালানোর জন্য Execute ক্লিক করুন।

সর্বাধিক প্রত্যাশিত প্রতিক্রিয়া, যদি অনুরোধটি সার্ভার দ্বারা সঠিকভাবে প্রক্রিয়া করা হয়, কোড 200 থাকে এবং প্রতিক্রিয়া গঠনটি কেমন হওয়া উচিত তা দেখায়।

response 200

  • 401 - অনুরোধটি সফলভাবে সম্পন্ন হয়নি কারণ প্রয়োজনীয় অনুমোদন টোকেন অনুপস্থিত বা অবৈধ।

    response 401

  • 404 - অনুরোধটি সফলভাবে প্রক্রিয়া করা হয়েছে, কিন্তু অনুরোধ করা সংস্থানটি পাওয়া যায়নি।

    response 404

  • 422 - অনুরোধের ইনপুটে ভুল প্যারামিটার পাস করা হয়েছে।

    response 1200

  • 500 - সার্ভার দ্বারা অনুরোধ প্রক্রিয়াকরণে একটি ত্রুটি৷

    response 500

কাস্টম ত্রুটি বাড়ান

কাস্টম বিপি এবং সম্পর্কিত অনুরোধগুলির জন্য, বিপি সম্পাদকে Raise Error ব্লক ব্যবহার করে বর্ণনা সহ কাস্টম ত্রুটি কোড তৈরি করা সম্ভব। এই ধরনের প্রক্রিয়ার একটি উদাহরণ নীচে দেওয়া হল:

example

এই ক্ষেত্রে, উপরের BP-এর সাথে যুক্ত এন্ডপয়েন্টের অনুরোধ ব্যর্থ হলে, সার্ভার DB: Create Candidate block । এই উদাহরণে ত্রুটি কোড ব্যবহারকারী নির্দিষ্ট যে কোনো একটি হতে পারে.

দ্রষ্টব্য: HTTP 418 I'm a teapot ক্লায়েন্ট ত্রুটি প্রতিক্রিয়া কোড নির্দেশ করে যে সার্ভার কফি তৈরি করতে অস্বীকার করে কারণ এটি স্থায়ীভাবে, একটি চাপানি। একটি সম্মিলিত কফি/চা পাত্র যা সাময়িকভাবে কফির বাইরে থাকে তার পরিবর্তে 503 ফেরত দেওয়া উচিত। এই ত্রুটিটি 1998 এবং 2014 সালে এপ্রিল ফুলের জোকসে সংজ্ঞায়িত Hyper Text Coffee Pot Control Protocol একটি রেফারেন্স।

Was this article helpful?

AppMaster.io 101 ক্র্যাশ কোর্স

10 মডিউল
2 সপ্তাহ

কোথা থেকে শুরু করবেন নিশ্চিত নন? নতুনদের জন্য আমাদের ক্র্যাশ কোর্সে যান এবং A থেকে Z পর্যন্ত AppMaster অন্বেষণ করুন।

কোর্স শুরু করুন
Development it’s so easy with AppMaster!

আরো সাহায্য প্রয়োজন?

আমাদের বিশেষজ্ঞদের সাহায্যে যেকোনো সমস্যা সমাধান করুন। সময় বাঁচান এবং আপনার অ্যাপ্লিকেশন তৈরিতে ফোকাস করুন।

headphones

যোগাযোগ সমর্থন

আপনার সমস্যা সম্পর্কে আমাদের বলুন, এবং আমরা আপনাকে একটি সমাধান খুঁজে বের করব।

message

সম্প্রদায় চ্যাট

আমাদের চ্যাটে অন্যান্য ব্যবহারকারীদের সাথে প্রশ্ন নিয়ে আলোচনা করুন।

কমিউনিটিতে যোগ দিন