คู่มือนี้อธิบายวิธีที่ Merchant API จัดการการกำหนดเวอร์ชัน การเปิดตัว และ
วงจรของเวอร์ชันต่างๆ
รูปแบบการกำหนดเวอร์ชัน
Merchant API ใช้กลยุทธ์การกำหนดเวอร์ชันที่ระดับ API ย่อย ซึ่งหมายความว่า API แต่ละรายการ เช่น ผลิตภัณฑ์ภายใน Merchant API จะมีวงจรเวอร์ชันของตัวเอง
รูปแบบและการนำเสนอการควบคุมเวอร์ชัน
เวอร์ชันย่อยของ API ที่เสถียร: หาก API ย่อยอยู่ในเวอร์ชันเสถียร แสดงว่าเมธอดทั้งหมดของ API ย่อยนั้นอยู่ในเวอร์ชันเสถียร เวอร์ชันย่อยของ API ที่เสถียรจะแสดงเป็น vX (เช่น v1, v2) ซึ่งเป็นเวอร์ชันหลักที่พร้อมใช้งานจริง
เวอร์ชันย่อยของ API ระดับอัลฟ่า: หาก API ย่อยอยู่ในระดับอัลฟ่า เมธอดทั้งหมดของ API ย่อยนั้นจะอยู่ในระดับอัลฟ่า เวอร์ชันย่อยของ API ระดับอัลฟ่าจะแสดงเป็น
vXalpha (เช่น v1alpha, v2alpha) โดยจะมีฟีเจอร์เวอร์ชันทดลองและฟีเจอร์ทดลองใช้ก่อนเปิดตัวที่มีไว้สำหรับการทดสอบและการทำซ้ำอย่างรวดเร็ว
เวอร์ชันอัลฟ่าไม่มีการรับประกันความเสถียร ไม่มีอายุการใช้งานที่กำหนด
และอาจมีการเปลี่ยนแปลงหรือหยุดให้บริการโดยมีระยะเวลาแจ้งล่วงหน้า 30 วัน
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-09-03 UTC"],[],[],null,["This guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\nVersioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\nVersion changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API\n will be released to the alpha channel of the latest stable version or\n directly to the latest stable version.\n\nSunset policy\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reports | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- 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.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
