نسخه سازی

این راهنما توضیح می‌دهد که Merchant API چگونه نسخه‌سازی، انتشار و چرخه عمر نسخه‌های مختلف خود را مدیریت می‌کند.

طرح نسخه سازی

Merchant API از یک استراتژی نسخه‌سازی در سطح API فرعی استفاده می‌کند. این بدان معناست که اجزا یا سرویس‌های جداگانه در Merchant API چرخه عمر نسخه خود را خواهند داشت.

فرمت نسخه سازی و ارائه

• نسخه های پایدار زیر API: اگر یک زیر API در نسخه پایدار باشد، تمام روش های آن در نسخه پایدار هستند. نسخه پایدار زیر API به صورت vX نمایش داده می شود (به عنوان مثال، v1، v2). اینها نسخه های اصلی آماده تولید هستند.

• نسخه های زیر API آلفا: اگر یک زیر API در نسخه آلفا باشد، تمام روش های آن در نسخه آلفا هستند. نسخه زیر API آلفا به صورت vXalpha نمایش داده می شود (به عنوان مثال، v1alpha، v2alpha). این‌ها نسخه‌های آزمایشی، دسترسی اولیه برای آزمایش و تکرار سریع هستند. نسخه های آلفا بدون تضمین ثبات و بدون طول عمر تضمین شده ارائه می شوند. نسخه های آلفا را می توان با یک دوره اطلاع رسانی 30 روزه تغییر داد یا متوقف کرد.

نسخه تغییر می کند

• افزایش‌های نسخه اصلی (مثلاً v1 تا v2): این تغییرات ناسازگار با عقب و شکستن را نشان می‌دهد که نیاز به اقدام توسعه‌دهنده دارد. فقط شکستن تغییرات APIهای فرعی پایدار دارای شماره نسخه جدید خواهد بود. به عنوان مثال، v1 تا v2.

• تغییرات جزئی: اضافات یا اصلاحات سازگار با عقب به عنوان تغییرات در نسخه اصلی موجود ارائه می شوند. چنین تغییراتی در یادداشت‌های انتشار آن نسخه اصلی به تفصیل بیان خواهد شد. افزودنی‌های بدون شکست به یک API فرعی در کانال آلفا آخرین نسخه پایدار یا مستقیماً به آخرین نسخه پایدار منتشر می‌شوند.

غروب

ما به صورت دوره‌ای نسخه‌های قدیمی‌تر زیرمجموعه Merchant را غروب می‌کنیم. ما متعهد به یک پنجره 12 ماهه انحلال برای نسخه‌های اصلی پایدار (vX) هستیم که از زمان اعلام رسمی منسوخ شدن شروع می‌شود.

به‌عنوان مثال، اگر نسخه 1 از API فرعی محصولات را در 15 ژانویه 2026 منسوخ کنیم، زودتر از 15 ژانویه 2027 غروب نمی‌کند. پس از این تاریخ، نسخه قبلی زیر API دیگر برای استفاده در دسترس نخواهد بود.

نسخه زیر API و وضعیت چرخه عمر

جدول زیر آخرین نسخه‌های هر زیر API Merchant API را فهرست می‌کند:

بهترین شیوه ها

• به طور منظم یادداشت‌های انتشار و آخرین به‌روزرسانی‌ها را برای نسخه‌های جدید، به‌روزرسانی‌های اصلی، بهبودها، و اطلاعیه‌های مربوط به راه‌اندازی و لغو APIهای فرعی بررسی کنید.
• اگر یک API فرعی دارای 2 یا بیشتر نسخه پایدار است، پیشنهاد می کنیم همیشه از آخرین نسخه استفاده کنید.
• برنامه خود را طوری طراحی کنید که به‌خوبی خطاهای زیر API، از جمله مشکلات شبکه، محدودیت‌های نرخ، و کدهای خطا یا پیام‌هایی را که ممکن است با نسخه‌های زیر API جدیدتر معرفی شوند، مدیریت کند.
• منتظر نمانید تا یک نسخه API فرعی در حال غروب آفتاب باشد تا برنامه ریزی ارتقای خود را شروع کنید. ارزیابی و آزمایش نسخه های جدید را به محض در دسترس بودن شروع کنید.
• برای درخواست های ویژگی یا نگرانی در مورد نقشه راه زیر API، با سؤال یا بازخورد با ما تماس بگیرید . برای اطلاعات در مورد نحوه تماس با تیم Merchant API برای پشتیبانی فنی، به دریافت راهنمایی درباره Merchant API مراجعه کنید.