সংস্করণ করা

This guide explains how Merchant API handles versioning, releases, and the lifecycle of its different versions.

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

Merchant API employs a versioning strategy at the sub-API level. This means that each Merchant API, for example Products within the Merchant API, will have its own version lifecycle.

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

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

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

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

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

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

We periodically sunset older Merchant sub-API versions. We commit to a 12-month deprecation window for stable major versions (vX), starting from the official deprecation announcement.

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

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

The following table lists the latest versions of each sub-API of Merchant API:

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

• Regularly check the release notes and latest updates for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.
• If a sub-API has two or more stable versions, we suggest using the latest version at all times.
• আপনার অ্যাপ্লিকেশনটি এমনভাবে ডিজাইন করুন যাতে এটি বিভিন্ন সাব-এপিআই ত্রুটি, যেমন—নেটওয়ার্ক সমস্যা, রেট লিমিট এবং নতুন সাব-এপিআই সংস্করণগুলোর সাথে আসা নতুন ত্রুটি কোড বা বার্তাগুলো—সুষ্ঠুভাবে সামলাতে পারে।
• Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.
• ফিচার অনুরোধ অথবা কোনো সাব-এপিআই রোডম্যাপ সংক্রান্ত জিজ্ঞাসা বা উদ্বেগের জন্য, প্রশ্ন বা মতামতসহ আমাদের সাথে যোগাযোগ করুন । প্রযুক্তিগত সহায়তার জন্য মার্চেন্ট এপিআই টিমের সাথে কীভাবে যোগাযোগ করবেন, সে সম্পর্কে তথ্যের জন্য ‘মার্চেন্ট এপিআই-এর জন্য সাহায্য নিন’ দেখুন।