The Catalog Versioning API allows you to determine what version of the Wix-Stores Catalog a site is using.
The two versions of the catalog ARE NOT backwards compatible. Supporting both versions of the catalog is critical, as sites will be spread across both versions.
In order to support our customer's needs and to support the best practices in a modern ecommerce platform, WixStores has developed a new API. Designated Catalog V3, this new API will allow a more fine-grained control of your store, as well as much better performance. This new API will make adding new features much easier, not only for Wix developers, but also for TPAs and Velo developers.
Unfortunately, not every store will be able to take advantage of this new API right away. Because of this, in order to use the Catalog API, services will need to first check which version of the Catalog is being used on a specific site.
In order to determine which API to use, it is important to call the GetCatalogVersion
endpoint at the beginning of each flow.
V1 Domain events will be sent for all updates to the catalog, even for sites using the V3 catalog. Each domain event has a new CatalogVersion
field.
This field can take the values V1_CATALOG
or V3_CATALOG
. This data can be used instead of calling the Versioning API.
It’s important to note the following points before starting to code:
GetCatalogVersion
endpoint takes no parameters. All necessary information is contained within your AUTH
header.CATALOG_V3
, it will not be downgraded to CATALOG_V1