ভার্সনিং

এই নির্দেশিকা থেকে জানতে পারবেন যে Merchant API কীভাবে ভার্সন, রিলিজ এবং এর বিভিন্ন ভার্সনের লাইফসাইকেল ম্যানেজ করে।

ভার্সনিং স্কিম

Merchant API সাব-API লেভেলে ভার্সনিং স্ট্র্যাটেজি প্রয়োগ করে। এর অর্থ হল, প্রতিটি Merchant API, যেমন Merchant API-এর মধ্যে থাকা প্রোডাক্ট, সেগুলির নিজস্ব ভার্সন লাইফসাইকেল থাকবে।

ভার্সন সংক্রান্ত ফর্ম্যাট ও প্রেজেন্টেশন

• স্টেবল সাব-API ভার্সন: কোনও সাব-API স্টেবল ভার্সনে থাকলে, তার সব পদ্ধতি স্টেবল ভার্সনে থাকে। একটি স্টেবল সাব-API ভার্সন vX (যেমন, v1, v2) হিসেবে দেখানো হয়। এগুলি হল প্রোডাকশনের জন্য প্রস্তুত মেজর ভার্সন।

• আলফা সাব-API ভার্সন: কোনও সাব-API আলফা ভার্সনে থাকলে, সেটির সব পদ্ধতি আলফা ভার্সনে থাকে। আলফা সাব-API ভার্সন এইভাবে দেখানো হয় vXalpha (যেমন, v1alpha, v2alpha)। এতে পরীক্ষামূলক, আগেভাগে অ্যাক্সেস ফিচার থাকে যা টেস্টিং ও দ্রুত ইটারেশনের জন্য তৈরি করা হয়েছে। আলফা ভার্সনের ক্ষেত্রে স্থায়িত্বের কোনও নিশ্চয়তা থাকে না, এর কোনও নির্দিষ্ট মেয়াদ নেই এবং ৩০ দিনের নোটিশ পিরিয়ড দিয়ে এটি পরিবর্তন বা বন্ধ করা হতে পারে।

ভার্সন পরিবর্তন

• মেজর ভার্সন ইনক্রিমেন্ট (যেমন, v1 থেকে v2): এগুলি ব্যাকওয়ার্ড-ইনকমপ্যাটিবল এবং ব্রেকিং পরিবর্তনকে সিগন্যাল করে, যার জন্য ডেভেলপারকে অ্যাকশন নিতে হয়। স্টেবল সাব-API-এর ব্রেকিং পরিবর্তন হলে তবেই নতুন ভার্সন নম্বর দেওয়া হবে। যেমন, v1 থেকে v2।
• ছোটখাটো পরিবর্তন: ব্যাকওয়ার্ড কম্প্যাটিবল সংযোজন বা সমাধানগুলি বর্তমান মেজর ভার্সনে পরিবর্তন হিসেবে উপস্থাপন করা হয়। এই ধরনের পরিবর্তনগুলি সেই মেজর ভার্সনের রিলিজ নোটগুলিতে বিস্তারিতভাবে উল্লেখ করা হবে। সাব-API-তে নন-ব্রেকিং সংযোজন লেটেস্ট স্টেবল ভার্সনের আলফা চ্যানেলে বা সরাসরি লেটেস্ট স্টেবল ভার্সনে রিলিজ করা হবে।

সানসেট নীতি

আমরা নির্দিষ্ট সময় অন্তর পুরনো Merchant সাব-API ভার্সন বন্ধ করে দিই। আমরা স্টেবল মেজর ভার্সনের (vX) জন্য ১২ মাসের ডেপ্রিকেশন উইন্ডোর প্রতিশ্রুতি দিই, যা অফিসিয়াল ডেপ্রিকেশন ঘোষণা থেকে শুরু হয়।

যেমন, আমরা যদি ১৫ জানুয়ারি, ২০২৬-এ প্রোডাক্ট সাব-API-এর v1 বন্ধ করে দিই, তাহলে এটি ১৫ জানুয়ারি, ২০২৭-এর আগে বন্ধ হবে না। এই তারিখের পরে, সাব-API-এর আগের ভার্সন আর ব্যবহার করা যাবে না।

সাব-API ভার্সন ও লাইফসাইকেল স্ট্যাটাস

নিচের সারণীতে Merchant API-এর প্রতিটি সাব-API-এর লেটেস্ট ভার্সন তালিকাভুক্ত করা হয়েছে:

সাব-API	বিভিন্ন ভার্সন	স্ট্যাটাস
অ্যাকাউন্ট	v1 v1alpha	Active Active
কনভার্সন	v1	অ্যাক্টিভ
ডেটা সোর্স	v1	অ্যাক্টিভ
ইনভেনটরি	v1	অ্যাক্টিভ
সমস্যার সমাধান	v1	অ্যাক্টিভ
স্থানীয় ফিডের পার্টনারশিপ	v1	অ্যাক্টিভ
বিজ্ঞপ্তি পান	v1	অ্যাক্টিভ
অর্ডার ট্র্যাকিং	v1	অ্যাক্টিভ
প্রোডাক্ট	v1	অ্যাক্টিভ
Product Studio	v1alpha	অ্যাক্টিভ
প্রচার	v1	অ্যাক্টিভ
কোটা	v1	অ্যাক্টিভ
রিপোর্ট	v1	অ্যাক্টিভ
রিভিউ	v1alpha	অ্যাক্টিভ

পেশাদার পদ্ধতি

• নতুন ভার্সন, প্রধান আপডেট, উন্নতি এবং সাব-API লঞ্চ ও বন্ধ হয়ে যাওয়া সম্পর্কে ঘোষণার জন্য নিয়মিত রিলিজ নোট ও লেটেস্ট আপডেট চেক করুন।
• কোনও সাব-API-এর দুই বা তার বেশি স্টেবল ভার্সন থাকলে, আমরা সবসময় লেটেস্ট ভার্সন ব্যবহার করার সাজেশন দিই।
• নেটওয়ার্ক সংক্রান্ত সমস্যা, রেট লিমিট এবং নতুন সাব-API ভার্সনের সাথে নতুন ত্রুটি কোড বা মেসেজ সহ বিভিন্ন সাব-API ত্রুটি যাতে সুন্দরভাবে ম্যানেজ করা যায় সেইভাবে আপনার অ্যাপ্লিকেশন ডিজাইন করুন।
• সাব-API ভার্সন বন্ধ হওয়ার আগে পর্যন্ত অপেক্ষা না করে, আপনার আপগ্রেড করার পরিকল্পনা শুরু করুন। নতুন ভার্সন উপলভ্য হওয়ার সাথে সাথেই সেগুলির মূল্যায়ন ও পরীক্ষা করা শুরু করুন।
• ফিচার সংক্রান্ত অনুরোধ বা সাব-API রোডম্যাপ সম্পর্কে কোনও উদ্বেগ থাকলে, প্রশ্ন বা মতামত সহ আমাদের সাথে যোগাযোগ করুন। প্রযুক্তিগত সহায়তার জন্য Merchant API টিমের সাথে কীভাবে যোগাযোগ করবেন সেই সম্পর্কে তথ্য পেতে, Merchant API-এর ব্যাপারে সহায়তা পান দেখুন।