সংস্করণ করা

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

সংস্করণ প্রকল্প

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

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

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

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

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

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

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

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

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

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

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

নিম্নলিখিত টেবিলে Merchant API-এর প্রতিটি সাব-API-এর সর্বশেষ সংস্করণগুলি তালিকাভুক্ত করা হয়েছে:

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

সেরা অনুশীলন

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