এইচটিটিপি এপিআই এর শেষ পয়েন্ট নিন যা নিম্নলিখিত প্রতিক্রিয়া মডেলটির বাইরে চলে যায়:
{
"type": "Dog",
"name": "Jessi",
...
}
typeমাঠের এক হচ্ছে হিসাবে ডকুমেন্টেশন বর্ণিত হয়েছে Dog, Catবা Fish।
একটি নতুন বিকল্প যুক্ত করা হবে, বলুন Rat, একটি ব্রেকিং এপিআই পরিবর্তন হিসাবে বিবেচনা করা হবে?
কোনও সীমাবদ্ধ তালিকায় একটি বিকল্প যুক্ত করা (যা কোনও বিকাশকারী স্যুইচ করতে পারে) কোনও এপিআই-তে কোনও এক্সটেনশন বা কোনও পরিবর্তন বিবেচনা করে?
উত্তর:
ডকুমেন্টেশন যদি এই ক্ষেত্রটিকে কুকুর, বিড়াল বা মাছের মধ্যে একটি হিসাবে বর্ণনা করে, তবে হ্যাঁ, অন্য প্রকার যুক্ত করে ইন্টারফেসটিকে পিছনের দিকে-অসামঞ্জস্যভাবে পরিবর্তন করে। এটি সম্পূর্ণরূপে অনুমেয় যে আপনার API এর গ্রাহক কুকুর এবং বিড়ালের সাথে মাছের চেয়ে আলাদাভাবে আচরণ করার জন্য নির্দিষ্ট কোড লিখেছেন। একটি অজানা প্রকার দেওয়া হয়েছে, সেই ভোক্তা আপনার প্রতিক্রিয়াটি কী করতে পারে তা জানতেন না। তবে এটি আপনার প্রকৃত সমস্যা ডোমেনে এই স্থানধারক ধরণের "বিড়াল" এবং "ফিশ" কী উপস্থাপন করে তার উপর এটি অনেকটাই নির্ভর করে ...
যদি সম্ভাব্য ধরণের তালিকার পরিবর্তনগুলি ঘন ঘন হয়, বা যদি তালিকাটি সীমাবদ্ধ না হয় তবে এটিকে নথিভুক্ত করা বুদ্ধিমান। আপনার ব্যবহারের ক্ষেত্রে উপর নির্ভর করে আপনার API এন্ডপয়েন্ট হিসাবে সমস্ত সম্ভাব্য প্রকারের একটি তালিকা প্রকাশ করা ভাল - এটি এপিআই সংস্করণ আপডেট না করে আপনি প্রকারগুলি যুক্ত করতে বা মুছতে পারবেন তা পরিষ্কার। যাইহোক, আপনার প্রকারগুলি যত বেশি গতিশীল, এপিআই গ্রাহকদের পক্ষে টাইপ-নির্দিষ্ট কিছু করা তত কঠিন। এক্সটেনসিবিলিটি বা ব্যবহারের স্বাচ্ছন্দ্য আপনার ব্যবহারের ক্ষেত্রে এবং আপনার সমস্যার ডোমেনের উপর নির্ভর করে important
এটি কেবল তখনই ভেঙে যাবে যদি বিদ্যমান ক্রিয়াকলাপ থেকে "ইঁদুর" ফিরিয়ে দেওয়া যায়।
যদি বিদ্যমান ক্রিয়াকলাপগুলি "ইঁদুর" ফিরে না আসতে পারে তবে এই নতুন বিকল্পটি যুক্ত করা কোনও প্রভাব ফেলবে না।