Release Notes

API version release notes

Release notes list all of the changes that are introduced by an API version. Use them to check whether your app is compatible with an API version, and what changes you might need to make before you migrate your app.
Version naming is done in a date format, and currently there are three versions: 2020-01, 2020-07, and 2022-01. It is recommended to start by looking for the content you need in the 2022-01 version.

2022-01

2022-01 release notes

Currently, most newly added applications are adopting this version. This version is widely adopted for its focus on stability, making it the foundation for Shoplazza’s new interfaces and features. Future updates will build upon this version.

The main components include: core interfaces related to the business blocks of products and extended fields (Metafield), styles, albums, product images, orders, logistics, transactions, stores, order risks, marketing (coupon codes, promotions, quantity discounts), reviews, buyers, inventory, Billing API, themes, custom pages, theme files, script_tags, and data analysis.

Breaking Changes

To ensure uninterrupted functionality, you must update your app to accommodate these changes. Failure to do so will result in app-breaking errors.

Rate Limits

The REST Admin API supports a limit of 40 requests per app per store per minute. This allotment replenishes at a rate of 2 requests per second.

Pagination

Cursor-based pagination has been implemented across Get Product List endpoints. Upcoming updates will expand this feature across additional endpoints.

Idempotent Requests

If an API request is disrupted in transit, then you might not receive a response. Use an idempotency key ensures the request is executed only once, and prevent duplicate operations.

Access Scopes

Add Get Access Scopes endpoint to retrieval the list of access scopes associated with the access.

Payment App Open API Support

Payment apps are public apps that integrate with the Shoplazza to provide payment processing services. Only approved partners will be able to build payment apps on Shoplazza's Payment Platform.
Using a payment app, merchants can redirect buyers to an app-hosted page for payment processing, which may include the following payment methods:

• Wallets
• Buy Now Pay Later / Installments / Buyer Financing
• Cards
• Bank Transfers / Online Banking
• Cryptocurrency
• Cash + ATM

Order Risk

Add Order Risk endpoint to get the risk information of orders.

2020-07

2020-01

Development Preview Version

Shoplazza releases new API versions every six months, and each version supports at least 12 months. The version name is based on the date, such as 2020-01. If your application calls a version that is no longer supported, it will return a 404 status when calling the request.

API with version

RESTful API URL： /openapi/{ version }/{ endpoint }.json

For example, the following URL calls version 2020-01：

RESTful API URL： /openapi/2020-01/products.json

Development Preview API

In order to quickly develop and iterate new API versions, we will also provide a development preview version of the API. The development preview version contains some experimental functional APIs, which may be unstable. Some APIs will be backward compatible, but some will not, and there is no guarantee that they will not be modified before becoming a stable version. If you The development preview version is used, please feel free to follow our version Change logs.

2020-01-02

The release of this version will be backward compatible with the previous historical version (API version released before 2020), that is, when you call:

RESTful API URL： /openapi/products.json

or

RESTful API URL： /openapi/api/open/products.json

Both are consistent with the results obtained by the following new calling method:

RESTful API URL： /openapi/2020-01/products.json

For reasons of forward compatibility, if your request does not include a version, the system will use the current stable version (2020-01) by default. We recommend that you migrate to the calling method with version number as soon as possible. In addition, please be aware that version calls after 2020-01 must be accompanied by the version number).