সংস্করণ করা

এই নির্দেশিকা ব্যাখ্যা করে যে কীভাবে মার্চেন্ট এপিআই সংস্করণ, রিলিজ এবং এর বিভিন্ন সংস্করণের জীবনচক্র পরিচালনা করে।

সংস্করণ স্কিম

মার্চেন্ট এপিআই সাব-এপিআই লেভেলে একটি ভার্সনিং কৌশল নিযুক্ত করে। এর অর্থ হল প্রতিটি API, উদাহরণস্বরূপ মার্চেন্ট API-এর মধ্যে থাকা পণ্যগুলির নিজস্ব সংস্করণের জীবনচক্র থাকবে৷

সংস্করণ বিন্যাস এবং উপস্থাপনা

• স্থিতিশীল সাব-এপিআই সংস্করণ: যদি একটি সাব-এপিআই একটি স্থিতিশীল সংস্করণে থাকে তবে এর সমস্ত পদ্ধতি একটি স্থিতিশীল সংস্করণে থাকে। একটি স্থিতিশীল সাব-এপিআই সংস্করণ vX হিসাবে উপস্থাপিত হয় (উদাহরণস্বরূপ, v1 , v2 )। এগুলি উত্পাদনের জন্য প্রস্তুত প্রধান সংস্করণ।

• আলফা সাব-এপিআই সংস্করণ: যদি একটি সাব-এপিআই একটি আলফাতে থাকে, তবে এর সমস্ত পদ্ধতি আলফাতে থাকে। একটি আলফা সাব-এপিআই সংস্করণ vXalpha হিসাবে উপস্থাপিত হয় (উদাহরণস্বরূপ, v1alpha , v2alpha )। এগুলিতে পরীক্ষামূলক, প্রাথমিক অ্যাক্সেস বৈশিষ্ট্য রয়েছে যা পরীক্ষা এবং দ্রুত পুনরাবৃত্তির উদ্দেশ্যে। আলফা সংস্করণে কোনো স্থিতিশীলতার নিশ্চয়তা নেই, কোনো সংজ্ঞায়িত জীবনকাল নেই এবং 30 দিনের নোটিশ সময়ের সাথে পরিবর্তন বা বন্ধ করা যেতে পারে।

সংস্করণ পরিবর্তন

• প্রধান সংস্করণ বৃদ্ধি (উদাহরণস্বরূপ, v1 থেকে v2): এইগুলি পশ্চাদমুখী-বেমানান এবং ব্রেকিং পরিবর্তনগুলির সংকেত দেয়, যার জন্য বিকাশকারীর পদক্ষেপ প্রয়োজন। শুধুমাত্র স্থিতিশীল সাব-এপিআইগুলির ব্রেকিং পরিবর্তনগুলির একটি নতুন সংস্করণ নম্বর থাকবে৷ উদাহরণস্বরূপ, v1 থেকে v2.

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

সূর্যাস্ত নীতি

আমরা পর্যায়ক্রমে পুরানো মার্চেন্ট সাব-এপিআই সংস্করণগুলি সানসেট করি। আমরা স্থিতিশীল প্রধান সংস্করণগুলির (vX) জন্য একটি 12-মাসের অবচয় উইন্ডোতে প্রতিশ্রুতিবদ্ধ, অফিসিয়াল অবচয় ঘোষণা থেকে শুরু করে।

উদাহরণস্বরূপ, যদি আমরা 15 জানুয়ারী, 2026-এ প্রোডাক্ট সাব-এপিআই-এর v1 বাতিল করি, তাহলে এটি 15 জানুয়ারী, 2027-এর আগে সূর্যাস্ত হবে না। এই তারিখের পরে, সাব-এপিআই-এর আগের সংস্করণটি আর ব্যবহারের জন্য উপলব্ধ থাকবে না।

সাব-এপিআই সংস্করণ এবং জীবনচক্রের স্থিতি

নিম্নলিখিত সারণীটি মার্চেন্ট API-এর প্রতিটি সাব-এপিআই-এর সর্বশেষ সংস্করণগুলিকে তালিকাভুক্ত করে:

সাব-এপিআই	সংস্করণ	স্ট্যাটাস
হিসাব	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
রূপান্তর	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
ডেটা উত্স	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
ইনভেন্টরি	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
সমস্যার সমাধান	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
স্থানীয় ফিড অংশীদারিত্ব	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
বিজ্ঞপ্তি	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
অর্ডার ট্র্যাকিং	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
পণ্য	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
পণ্য স্টুডিও	v1alpha	সক্রিয়
প্রচার	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
কোটা	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
রিপোর্টিং	v1 v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে
রিভিউ	v1alpha v1beta	সক্রিয় ফেব্রুয়ারী 28, 2026 এ বন্ধ করা হবে

সর্বোত্তম অনুশীলন

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