ওপেনএপিআই ডিফ কী?
ওপেনএপিআই ডিফ এই ব্রাউজারে দুটি OpenAPI ডকুমেন্ট তুলনা করে: A (পুরোনো) ও B (নতুন)। যোগ ও বাদ পড়া অপারেশন তালিকা করে, তারপর দুই দিকেই থাকা অপারেশনের প্যারামিটার ও রেসপন্স পরিবর্তন দেখায়। Breaking / compatible / uncertain লেবেল স্ট্রাকচারাল হিউরিস্টিক — কন্ট্রাক্ট-টেস্ট গ্যারান্টি নয়, ক্লায়েন্টও চালায় না। রিমোট $ref রিজলভ হয় না। স্পেক এই ট্যাবেই থাকে; আপলোড হয় না।
পুরোনো ও নতুন OpenAPI স্পেক পাশাপাশি রেখে অপারেশন যোগ, বাদ ও পরিবর্তন দেখুন। Breaking / compatible / uncertain লেবেল স্ট্রাকচারাল হিউরিস্টিক — ক্লায়েন্টের জন্য চূড়ান্ত গ্যারান্টি নয়। তুলনা এই ব্রাউজারে হয়; স্পেক আপলোড হয় না।
মূল বৈশিষ্ট্য
- পুরোনো (A) ও নতুন (B) OpenAPI পাশাপাশি পেস্ট
- যোগ, বাদ ও পরিবর্তিত অপারেশন
- শেয়ার করা অপারেশনে প্যারামিটার ও রেসপন্স নোট
- Breaking / compatible / uncertain হিউরিস্টিক — নিজে যাচাই করুন
- ব্রাউজার-লোকাল তুলনা; রিমোট $ref রিজলভ নয়
জনপ্রিয় ব্যবহার
- দুই ভার্সনের মধ্যে কোন এন্ডপয়েন্ট এসেছে বা গেছে দেখা
- রিলিজ নোটের আগে প্যারামিটার/রেসপন্স সম্পাদনা ধরা
- পুল রিকোয়েস্ট দেখার সময় দুই স্পেক ডিভাইসে রাখা
সাপোর্টেড ফরম্যাট
দুটি OpenAPI JSON/YAML পেস্ট। তুলনা এই ট্যাবে।
সমস্যা ও সমাধান
- সব uncertain বড় রিফ্যাক্টর ও নাম-বদলানো পাথ uncertain দেখায় কারণ ম্যাচার সিমান্টিক নয়, স্ট্রাকচারাল।
অন্য নামে: Swagger ডিফ, OpenAPI তুলনা, API ব্রেকিং স্ক্যান.
কীভাবে কাজ করে
- পুরোনো OpenAPI ডকুমেন্ট (A) ও নতুনটি (B) পেস্ট করুন।
- ডিফ চালান।
- যোগ, বাদ ও পরিবর্তিত অপারেশন সামঞ্জস্য লেবেলসহ দেখুন।
প্রশ্নোত্তর
লেবেল কি নিশ্চিত?
না। Breaking / compatible / uncertain স্ট্রাকচারাল হিউরিস্টিক। নিজের ক্লায়েন্টের জন্য সবসময় নিজে যাচাই করুন।
ব্রেকিং লেবেল কি নিশ্চিত?
না। স্ট্রাকচারাল হিউরিস্টিক। আসল ক্লায়েন্ট ও রানটাইমের জন্য সবসময় নিজে দেখুন।
API কি এক্সিকিউট করে?
না। আপনি যে ডকুমেন্ট পেস্ট করেছেন তার ডিফ। সার্ভার কল বা SDK জেনারেট করে না।