সংস্করণ করা

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

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

মার্চেন্ট এপিআই সাব-এপিআই পর্যায়ে একটি ভার্সনিং কৌশল প্রয়োগ করে। এর মানে হলো, প্রতিটি মার্চেন্ট এপিআই-এর, যেমন মার্চেন্ট এপিআই-এর অন্তর্ভুক্ত প্রোডাক্টগুলোর, নিজস্ব ভার্সন জীবনচক্র থাকবে।

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

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

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

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

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

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

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

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

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

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

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

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