All Release Notes
Smaller product payloads projected on locales
12 March 2020
Composable Commerce
HTTP API
Enhancement
CartsProduct catalogSearchProject configuration
When querying Product Projections the response payload contains all existing translations of localized fields. To remove unneeded translations and reduce the payload you can now use one of two new query parameters: storeProjection
and localeProjection
. In both cases the returned projections only contain values in the specified locales.
When using Stores, you can add languages to a given store and use storeProjection
to fetch the list of locales automatically from that store. Another benefit of this approach is that line items of carts bound to the store are projected accordingly.
If you don't use stores you can use localeProjection
to specify the needed locales directly in the query.
- [API] Stores can have languages configured. Only languages defined in the project can be used in stores.
- added
languages
to Store. - added
languages
to StoreDraft. - added update action
setLanguages
on Store.
- added
- [API] Added query parameter
localeProjection
on Product Projections for locale-based projections without Store. This parameter can be used on Get ProductProjection by ID, Get ProductProjection by Key, Query ProductProjections and Product Projection Search. - [API] Added query parameter
storeProjection
on Product Projections for locale-based projections with Store. This parameter can be used on Get ProductProjection by ID, Get ProductProjection by Key, Query ProductProjections and Product Projection Search. - [API] If a Cart is bound to a Store, all LocalizedStrings are filtered according to the locales defined in the store.