সংস্করণ করা

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

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

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

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

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

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

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

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

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

সূর্যাস্ত

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

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

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

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

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

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