@teamnovu/kit-shopware-composables 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.env +2 -0
- package/api-gen.config.json +5 -0
- package/api-types/storeApiSchema.json +12187 -0
- package/api-types/storeApiSchema.localhost.http +1043 -0
- package/api-types/storeApiSchema.overrides.json +1 -0
- package/api-types/storeApiTypes.d.ts +5909 -0
- package/docker/boot_end.sh +12 -0
- package/docker/docker-compose.yaml +22 -0
- package/docker/types.sh +14 -0
- package/eslint.config.mjs +84 -0
- package/package.json +49 -0
- package/src/context/useContextOptions.ts +16 -0
- package/src/context/useContextUpdate.ts +16 -0
- package/src/general/useSeoUrl.ts +18 -0
- package/src/index.ts +24 -0
- package/src/inject.ts +16 -0
- package/src/keys.ts +42 -0
- package/src/products/useCategoryQueryOptions.ts +25 -0
- package/src/products/useProductListingQueryOptions.test.ts +24 -0
- package/src/products/useProductListingQueryOptions.ts +28 -0
- package/src/products/useProductPrice.ts +136 -0
- package/src/products/useProductQueryOptions.ts +28 -0
- package/src/products/useProductVariantForOptions.ts +21 -0
- package/src/types/query.ts +18 -0
- package/src/usePagination.ts +72 -0
- package/src/util/url.ts +8 -0
- package/tsconfig.json +23 -0
- package/vite.config.js +39 -0
- package/vitest.config.js +10 -0
|
@@ -0,0 +1,1043 @@
|
|
|
1
|
+
@baseUrl = http://localhost:8500/store-api
|
|
2
|
+
@swLanguageId = 2fbb5fe2e29a4d70aa5854ce7ce3e20b
|
|
3
|
+
@swIncludeSeoUrls = true
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
###
|
|
7
|
+
|
|
8
|
+
# Fetch sitemaps
|
|
9
|
+
# Fetches a list of compressed sitemap files, which are often used by search engines.
|
|
10
|
+
# @name readSitemap
|
|
11
|
+
GET {{baseUrl}}/sitemap HTTP/1.1
|
|
12
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
13
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
14
|
+
|
|
15
|
+
###
|
|
16
|
+
|
|
17
|
+
# Download sitemap file
|
|
18
|
+
# Downloads the sitemap file from the configured sitemap storage.
|
|
19
|
+
# @name getSitemapFile
|
|
20
|
+
GET {{baseUrl}}/sitemap/{filePath} HTTP/1.1
|
|
21
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
22
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
23
|
+
|
|
24
|
+
###
|
|
25
|
+
|
|
26
|
+
# Fetch and resolve Media Entities
|
|
27
|
+
# Fetch one or multiple Media Entities with the corresponding Identifier.
|
|
28
|
+
# @name readMedia
|
|
29
|
+
POST {{baseUrl}}/media HTTP/1.1
|
|
30
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
31
|
+
Content-Type: application/json
|
|
32
|
+
|
|
33
|
+
{
|
|
34
|
+
"ids": []
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
###
|
|
38
|
+
|
|
39
|
+
# Initiate a payment for an order
|
|
40
|
+
# This generic endpoint is should be called to initiate a payment flow after an order has been created. The details of the payment flow can differ depending on the payment integration and might require calling additional operations or the setup of webhooks.
|
|
41
|
+
#
|
|
42
|
+
# The endpoint internally calls the payment handler of the payment method currently set for the order.
|
|
43
|
+
# @name handlePaymentMethod
|
|
44
|
+
POST {{baseUrl}}/handle-payment HTTP/1.1
|
|
45
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
46
|
+
Content-Type: application/json
|
|
47
|
+
|
|
48
|
+
{
|
|
49
|
+
"orderId": "string",
|
|
50
|
+
"finishUrl": "string",
|
|
51
|
+
"errorUrl": "string"
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
###
|
|
55
|
+
|
|
56
|
+
# Fetch languages
|
|
57
|
+
# Perform a filtered search for languages.
|
|
58
|
+
# @name readLanguages
|
|
59
|
+
POST {{baseUrl}}/language HTTP/1.1
|
|
60
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
61
|
+
Content-Type: application/json
|
|
62
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
63
|
+
|
|
64
|
+
{}
|
|
65
|
+
|
|
66
|
+
###
|
|
67
|
+
|
|
68
|
+
# Add a product to a wishlist
|
|
69
|
+
# Adds a product to a customers wishlist.
|
|
70
|
+
#
|
|
71
|
+
# **Important constraints**
|
|
72
|
+
#
|
|
73
|
+
# * Anonymous (not logged-in) customers can not have wishlists.
|
|
74
|
+
# * The wishlist feature has to be activated.
|
|
75
|
+
# @name addProductOnWishlist
|
|
76
|
+
POST {{baseUrl}}/customer/wishlist/add/{productId} HTTP/1.1
|
|
77
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
78
|
+
|
|
79
|
+
###
|
|
80
|
+
|
|
81
|
+
# Fetch a wishlist
|
|
82
|
+
# Fetch a customer's wishlist. Products on the wishlist can be filtered using a criteria object.
|
|
83
|
+
#
|
|
84
|
+
# **Important constraints**
|
|
85
|
+
#
|
|
86
|
+
# * Anonymous (not logged-in) customers can not have wishlists.
|
|
87
|
+
# * The wishlist feature has to be activated.
|
|
88
|
+
# @name readCustomerWishlist
|
|
89
|
+
POST {{baseUrl}}/customer/wishlist HTTP/1.1
|
|
90
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
91
|
+
Content-Type: application/json
|
|
92
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
93
|
+
|
|
94
|
+
{}
|
|
95
|
+
|
|
96
|
+
###
|
|
97
|
+
|
|
98
|
+
# Create a wishlist for a customer
|
|
99
|
+
# Create a new wishlist for a logged in customer or extend the existing wishlist given a set of products.
|
|
100
|
+
#
|
|
101
|
+
# **Important constraints**
|
|
102
|
+
#
|
|
103
|
+
# * Anonymous (not logged-in) customers can not have wishlists.
|
|
104
|
+
# * A customer can only have a single wishlist.
|
|
105
|
+
# * The wishlist feature has to be activated.
|
|
106
|
+
# @name mergeProductOnWishlist
|
|
107
|
+
POST {{baseUrl}}/customer/wishlist/merge HTTP/1.1
|
|
108
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
109
|
+
Content-Type: application/json
|
|
110
|
+
|
|
111
|
+
{
|
|
112
|
+
"productIds": []
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
###
|
|
116
|
+
|
|
117
|
+
# Remove a product from a wishlist
|
|
118
|
+
# Removes a product from a customer's wishlist.
|
|
119
|
+
#
|
|
120
|
+
# **Important constraints**
|
|
121
|
+
#
|
|
122
|
+
# * Anonymous (not logged-in) customers can not have wishlists.
|
|
123
|
+
# * The wishlist feature has to be activated.
|
|
124
|
+
# @name deleteProductOnWishlist
|
|
125
|
+
DELETE {{baseUrl}}/customer/wishlist/delete/{productId} HTTP/1.1
|
|
126
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
127
|
+
|
|
128
|
+
###
|
|
129
|
+
|
|
130
|
+
# Access point for different api logics which are provided by apps over script hooks
|
|
131
|
+
# @name getScriptStoreApiRoute
|
|
132
|
+
GET {{baseUrl}}/script/{hook} HTTP/1.1
|
|
133
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
134
|
+
|
|
135
|
+
###
|
|
136
|
+
|
|
137
|
+
# Access point for different api logics which are provided by apps over script hooks
|
|
138
|
+
# @name postScriptStoreApiRoute
|
|
139
|
+
POST {{baseUrl}}/script/{hook} HTTP/1.1
|
|
140
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
141
|
+
|
|
142
|
+
###
|
|
143
|
+
|
|
144
|
+
# Fetch a landing page with the resolved CMS page
|
|
145
|
+
# Loads a landing page by its identifier and resolves the CMS page.
|
|
146
|
+
#
|
|
147
|
+
# **Important notice**
|
|
148
|
+
#
|
|
149
|
+
# The criteria passed with this route also affects the listing, if there is one within the cms page.
|
|
150
|
+
# @name readLandingPage
|
|
151
|
+
POST {{baseUrl}}/landing-page/{landingPageId} HTTP/1.1
|
|
152
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
153
|
+
Content-Type: application/json
|
|
154
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
155
|
+
|
|
156
|
+
{}
|
|
157
|
+
|
|
158
|
+
###
|
|
159
|
+
|
|
160
|
+
# Fetch SEO routes
|
|
161
|
+
# Perform a filtered search for seo urls.
|
|
162
|
+
# @name readSeoUrl
|
|
163
|
+
POST {{baseUrl}}/seo-url HTTP/1.1
|
|
164
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
165
|
+
Content-Type: application/json
|
|
166
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
167
|
+
|
|
168
|
+
{}
|
|
169
|
+
|
|
170
|
+
###
|
|
171
|
+
|
|
172
|
+
# Fetch the current context
|
|
173
|
+
# Fetches the current context. This includes for example the `customerGroup`, `currency`, `taxRules` and many more.
|
|
174
|
+
# @name readContext
|
|
175
|
+
GET {{baseUrl}}/context HTTP/1.1
|
|
176
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
177
|
+
|
|
178
|
+
###
|
|
179
|
+
|
|
180
|
+
# Modify the current context
|
|
181
|
+
# Used for switching the context. A typical example would be changing the language or changing the currency.
|
|
182
|
+
# @name updateContext
|
|
183
|
+
PATCH {{baseUrl}}/context HTTP/1.1
|
|
184
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
185
|
+
Content-Type: application/json
|
|
186
|
+
|
|
187
|
+
{
|
|
188
|
+
"currencyId": "string",
|
|
189
|
+
"languageId": "string",
|
|
190
|
+
"billingAddressId": "string",
|
|
191
|
+
"shippingAddressId": "string",
|
|
192
|
+
"paymentMethodId": "string",
|
|
193
|
+
"shippingMethodId": "string",
|
|
194
|
+
"countryId": "string",
|
|
195
|
+
"countryStateId": "string"
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
###
|
|
199
|
+
|
|
200
|
+
# Search for products
|
|
201
|
+
# Performs a search for products which can be used to display a product listing.
|
|
202
|
+
# @name searchPage
|
|
203
|
+
POST {{baseUrl}}/search HTTP/1.1
|
|
204
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
205
|
+
Content-Type: application/json
|
|
206
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
207
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
208
|
+
|
|
209
|
+
{}
|
|
210
|
+
|
|
211
|
+
###
|
|
212
|
+
|
|
213
|
+
# Submit a contact form message
|
|
214
|
+
# Used for submitting contact forms. Be aware that there can be more required fields, depending on the system settings.
|
|
215
|
+
# @name sendContactMail
|
|
216
|
+
POST {{baseUrl}}/contact-form HTTP/1.1
|
|
217
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
218
|
+
Content-Type: application/json
|
|
219
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
220
|
+
|
|
221
|
+
{
|
|
222
|
+
"salutationId": "string",
|
|
223
|
+
"firstName": "string",
|
|
224
|
+
"lastName": "string",
|
|
225
|
+
"email": "string",
|
|
226
|
+
"phone": "string",
|
|
227
|
+
"subject": "string",
|
|
228
|
+
"comment": "string",
|
|
229
|
+
"navigationId": "string",
|
|
230
|
+
"slotId": "string",
|
|
231
|
+
"cmsPageType": "string",
|
|
232
|
+
"entityName": "string"
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
###
|
|
236
|
+
|
|
237
|
+
# Get API routes
|
|
238
|
+
# @name getRoutes
|
|
239
|
+
GET {{baseUrl}}/_info/routes HTTP/1.1
|
|
240
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
241
|
+
|
|
242
|
+
###
|
|
243
|
+
|
|
244
|
+
# Fetch or create a cart
|
|
245
|
+
# Used to fetch the current cart or for creating a new one.
|
|
246
|
+
# @name readCart
|
|
247
|
+
GET {{baseUrl}}/checkout/cart HTTP/1.1
|
|
248
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
249
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
250
|
+
|
|
251
|
+
###
|
|
252
|
+
|
|
253
|
+
# Delete a cart
|
|
254
|
+
# This route deletes the cart of the customer.
|
|
255
|
+
# @name deleteCart
|
|
256
|
+
DELETE {{baseUrl}}/checkout/cart HTTP/1.1
|
|
257
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
258
|
+
|
|
259
|
+
###
|
|
260
|
+
|
|
261
|
+
# Add items to the cart
|
|
262
|
+
# This route adds items to the cart. An item can be a product or promotion for example. They are referenced by the `referencedId`-parameter.
|
|
263
|
+
#
|
|
264
|
+
# Example: [Working with the cart - Guide](https://developer.shopware.com/docs/guides/integrations-api/store-api-guide/work-with-the-cart#adding-new-items-to-the-cart)
|
|
265
|
+
# @name addLineItem
|
|
266
|
+
POST {{baseUrl}}/checkout/cart/line-item HTTP/1.1
|
|
267
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
268
|
+
Content-Type: application/json
|
|
269
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
270
|
+
|
|
271
|
+
{}
|
|
272
|
+
|
|
273
|
+
###
|
|
274
|
+
|
|
275
|
+
# Remove items from the cart
|
|
276
|
+
# DEPRECATED: use removeLineItem instead. This route removes items from the cart and recalculates it.
|
|
277
|
+
#
|
|
278
|
+
# Example: [Working with the cart - Guide](https://developer.shopware.com/docs/guides/integrations-api/store-api-guide/work-with-the-cart#deleting-items-in-the-cart)
|
|
279
|
+
# @name removeLineItemDeprecated
|
|
280
|
+
DELETE {{baseUrl}}/checkout/cart/line-item HTTP/1.1
|
|
281
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
282
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
283
|
+
|
|
284
|
+
###
|
|
285
|
+
|
|
286
|
+
# Update items in the cart
|
|
287
|
+
# This route updates items in the cart. A typical example is updating the quantity of an item.
|
|
288
|
+
#
|
|
289
|
+
# Example: [Working with the cart - Guide](https://developer.shopware.com/docs/guides/integrations-api/store-api-guide/work-with-the-cart#updating-items-in-the-cart)
|
|
290
|
+
# @name updateLineItem
|
|
291
|
+
PATCH {{baseUrl}}/checkout/cart/line-item HTTP/1.1
|
|
292
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
293
|
+
Content-Type: application/json
|
|
294
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
295
|
+
|
|
296
|
+
{}
|
|
297
|
+
|
|
298
|
+
###
|
|
299
|
+
|
|
300
|
+
# Remove items from the cart
|
|
301
|
+
# This route removes items from the cart and recalculates it.
|
|
302
|
+
#
|
|
303
|
+
# Example: [Working with the cart - Guide](https://developer.shopware.com/docs/guides/integrations-api/store-api-guide/work-with-the-cart#deleting-items-in-the-cart)
|
|
304
|
+
# @name removeLineItem
|
|
305
|
+
POST {{baseUrl}}/checkout/cart/line-item/delete HTTP/1.1
|
|
306
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
307
|
+
Content-Type: application/json
|
|
308
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
309
|
+
|
|
310
|
+
{
|
|
311
|
+
"ids": []
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
###
|
|
315
|
+
|
|
316
|
+
# Create an order from a cart
|
|
317
|
+
# Creates a new order from the current cart and deletes the cart.
|
|
318
|
+
#
|
|
319
|
+
# If you are using the [prepared payment flow](https://developer.shopware.com/docs/concepts/commerce/checkout-concept/payments#2.1-prepare-payment-optional), this endpoint also receives additional transaction details. The exact name of the parameters depends on the implementation of the corresponding *payment handler*.
|
|
320
|
+
# @name createOrder
|
|
321
|
+
POST {{baseUrl}}/checkout/order HTTP/1.1
|
|
322
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
323
|
+
Content-Type: application/json
|
|
324
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
325
|
+
|
|
326
|
+
{
|
|
327
|
+
"customerComment": "string",
|
|
328
|
+
"affiliateCode": "string",
|
|
329
|
+
"campaignCode": "string"
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
###
|
|
333
|
+
|
|
334
|
+
# Call the checkout gateway
|
|
335
|
+
# Call the checkout gateway, which is used to manipulate certain aspects of the checkout process (e.g. available payment methods).
|
|
336
|
+
# @name checkoutGateway
|
|
337
|
+
GET {{baseUrl}}/checkout/gateway HTTP/1.1
|
|
338
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
339
|
+
|
|
340
|
+
###
|
|
341
|
+
|
|
342
|
+
# Fetch cross-selling groups of a product
|
|
343
|
+
# This route is used to load the cross sellings for a product. A product has several cross selling definitions in which several products are linked. The route returns the cross sellings together with the linked products
|
|
344
|
+
# @name readProductCrossSellings
|
|
345
|
+
POST {{baseUrl}}/product/{productId}/cross-selling HTTP/1.1
|
|
346
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
347
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
348
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
349
|
+
|
|
350
|
+
###
|
|
351
|
+
|
|
352
|
+
# Fetch a single product
|
|
353
|
+
# This route is used to load a single product with the corresponding details. In addition to loading the data, the best variant of the product is determined when a parent id is passed.
|
|
354
|
+
# @name readProductDetail
|
|
355
|
+
POST {{baseUrl}}/product/{productId} HTTP/1.1
|
|
356
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
357
|
+
Content-Type: application/json
|
|
358
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
359
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
360
|
+
|
|
361
|
+
{}
|
|
362
|
+
|
|
363
|
+
###
|
|
364
|
+
|
|
365
|
+
# Fetch a list of products
|
|
366
|
+
# List products that match the given criteria. For performance reasons a limit should always be set.
|
|
367
|
+
# @name readProduct
|
|
368
|
+
POST {{baseUrl}}/product HTTP/1.1
|
|
369
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
370
|
+
Content-Type: application/json
|
|
371
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
372
|
+
|
|
373
|
+
{}
|
|
374
|
+
|
|
375
|
+
###
|
|
376
|
+
|
|
377
|
+
# Fetch product reviews
|
|
378
|
+
# Perform a filtered search for product reviews.
|
|
379
|
+
# @name readProductReviews
|
|
380
|
+
POST {{baseUrl}}/product/{productId}/reviews HTTP/1.1
|
|
381
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
382
|
+
Content-Type: application/json
|
|
383
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
384
|
+
|
|
385
|
+
{}
|
|
386
|
+
|
|
387
|
+
###
|
|
388
|
+
|
|
389
|
+
# Save a product review
|
|
390
|
+
# Saves a review for a product. Reviews have to be activated in the settings.
|
|
391
|
+
# @name saveProductReview
|
|
392
|
+
POST {{baseUrl}}/product/{productId}/review HTTP/1.1
|
|
393
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
394
|
+
Content-Type: application/json
|
|
395
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
396
|
+
|
|
397
|
+
{
|
|
398
|
+
"name": "string",
|
|
399
|
+
"email": "string",
|
|
400
|
+
"title": "string",
|
|
401
|
+
"content": "string",
|
|
402
|
+
"points": 0
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
###
|
|
406
|
+
|
|
407
|
+
# Search for a matching variant by product options.
|
|
408
|
+
# Performs a search for product variants and returns the best matching variant.
|
|
409
|
+
# @name searchProductVariantIds
|
|
410
|
+
POST {{baseUrl}}/product/{productId}/find-variant HTTP/1.1
|
|
411
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
412
|
+
Content-Type: application/json
|
|
413
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
414
|
+
|
|
415
|
+
{
|
|
416
|
+
"options": null,
|
|
417
|
+
"switchedGroup": "string"
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
###
|
|
421
|
+
|
|
422
|
+
# Fetch a navigation menu
|
|
423
|
+
# This endpoint returns categories that can be used as a page navigation. You can either return them as a tree or as a flat list. You can also control the depth of the tree.
|
|
424
|
+
#
|
|
425
|
+
# Instead of passing uuids, you can also use one of the following aliases for the activeId and rootId parameters to get the respective navigations of your sales channel.
|
|
426
|
+
#
|
|
427
|
+
# * main-navigation
|
|
428
|
+
# * service-navigation
|
|
429
|
+
# * footer-navigation
|
|
430
|
+
# @name readNavigation
|
|
431
|
+
POST {{baseUrl}}/navigation/{activeId}/{rootId} HTTP/1.1
|
|
432
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
433
|
+
Content-Type: application/json
|
|
434
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
435
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
436
|
+
|
|
437
|
+
{}
|
|
438
|
+
|
|
439
|
+
###
|
|
440
|
+
|
|
441
|
+
# Loads all available payment methods
|
|
442
|
+
# @name readPaymentMethod
|
|
443
|
+
POST {{baseUrl}}/payment-method HTTP/1.1
|
|
444
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
445
|
+
Content-Type: application/json
|
|
446
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
447
|
+
|
|
448
|
+
{}
|
|
449
|
+
|
|
450
|
+
###
|
|
451
|
+
|
|
452
|
+
# Export product export
|
|
453
|
+
# @name readProductExport
|
|
454
|
+
GET {{baseUrl}}/product-export/{accessKey}/{fileName} HTTP/1.1
|
|
455
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
456
|
+
|
|
457
|
+
###
|
|
458
|
+
|
|
459
|
+
# Fetch the states of a country
|
|
460
|
+
# Perform a filtered search the states for a country
|
|
461
|
+
# @name readCountryState
|
|
462
|
+
POST {{baseUrl}}/country-state/{countryId} HTTP/1.1
|
|
463
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
464
|
+
Content-Type: application/json
|
|
465
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
466
|
+
|
|
467
|
+
{}
|
|
468
|
+
|
|
469
|
+
###
|
|
470
|
+
|
|
471
|
+
# Fetch a product listing by category
|
|
472
|
+
# Fetches a product listing for a specific category. It also provides filters, sortings and property aggregations, analogous to the /search endpoint.
|
|
473
|
+
# @name readProductListing
|
|
474
|
+
POST {{baseUrl}}/product-listing/{categoryId} HTTP/1.1
|
|
475
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
476
|
+
Content-Type: application/json
|
|
477
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
478
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
479
|
+
|
|
480
|
+
{}
|
|
481
|
+
|
|
482
|
+
###
|
|
483
|
+
|
|
484
|
+
# Fetch newsletter recipients
|
|
485
|
+
# Perform a filtered search for newsletter recipients.
|
|
486
|
+
# @name readNewsletterRecipient
|
|
487
|
+
POST {{baseUrl}}/account/newsletter-recipient HTTP/1.1
|
|
488
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
489
|
+
Content-Type: application/json
|
|
490
|
+
|
|
491
|
+
{}
|
|
492
|
+
|
|
493
|
+
###
|
|
494
|
+
|
|
495
|
+
# Change the customer's information
|
|
496
|
+
# Make changes to a customer's account, like changing their name, salutation or title.
|
|
497
|
+
# @name changeProfile
|
|
498
|
+
POST {{baseUrl}}/account/change-profile HTTP/1.1
|
|
499
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
500
|
+
Content-Type: application/json
|
|
501
|
+
|
|
502
|
+
{
|
|
503
|
+
"salutationId": "string",
|
|
504
|
+
"title": "string",
|
|
505
|
+
"firstName": "string",
|
|
506
|
+
"lastName": "string",
|
|
507
|
+
"birthdayDay": 0,
|
|
508
|
+
"birthdayMonth": 0,
|
|
509
|
+
"birthdayYear": 0
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
###
|
|
513
|
+
|
|
514
|
+
# Change the customer's email address
|
|
515
|
+
# Changes a customer's email address to a new email address, using their current password as a validation.
|
|
516
|
+
# @name changeEmail
|
|
517
|
+
POST {{baseUrl}}/account/change-email HTTP/1.1
|
|
518
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
519
|
+
Content-Type: application/json
|
|
520
|
+
|
|
521
|
+
{
|
|
522
|
+
"email": "string",
|
|
523
|
+
"emailConfirmation": "string",
|
|
524
|
+
"password": "string"
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
###
|
|
528
|
+
|
|
529
|
+
# Change the customer's language.
|
|
530
|
+
# Changes the language of the logged in customer
|
|
531
|
+
# @name changeLanguage
|
|
532
|
+
POST {{baseUrl}}/account/change-language HTTP/1.1
|
|
533
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
534
|
+
Content-Type: application/json
|
|
535
|
+
|
|
536
|
+
{
|
|
537
|
+
"language": "string"
|
|
538
|
+
}
|
|
539
|
+
|
|
540
|
+
###
|
|
541
|
+
|
|
542
|
+
# Change the customer's password
|
|
543
|
+
# Changes a customer's password using their current password as a validation.
|
|
544
|
+
# @name changePassword
|
|
545
|
+
POST {{baseUrl}}/account/change-password HTTP/1.1
|
|
546
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
547
|
+
Content-Type: application/json
|
|
548
|
+
|
|
549
|
+
{
|
|
550
|
+
"password": "string",
|
|
551
|
+
"newPassword": "string",
|
|
552
|
+
"newPasswordConfirm": "string"
|
|
553
|
+
}
|
|
554
|
+
|
|
555
|
+
###
|
|
556
|
+
|
|
557
|
+
# Checks if the customer recovery entry for a given hash is expired.
|
|
558
|
+
# This can be used to validate a provided hash has a valid and not expired customer recovery hash.
|
|
559
|
+
# @name getCustomerRecoveryIsExpired
|
|
560
|
+
POST {{baseUrl}}/account/customer-recovery-is-expired HTTP/1.1
|
|
561
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
562
|
+
Content-Type: application/json
|
|
563
|
+
|
|
564
|
+
{
|
|
565
|
+
"hash": "string"
|
|
566
|
+
}
|
|
567
|
+
|
|
568
|
+
###
|
|
569
|
+
|
|
570
|
+
# Get information about current customer
|
|
571
|
+
# Returns information about the current customer.
|
|
572
|
+
# @name readCustomer
|
|
573
|
+
POST {{baseUrl}}/account/customer HTTP/1.1
|
|
574
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
575
|
+
Content-Type: application/json
|
|
576
|
+
|
|
577
|
+
{}
|
|
578
|
+
|
|
579
|
+
###
|
|
580
|
+
|
|
581
|
+
# Delete the customer's profile
|
|
582
|
+
# Deletes a customer profile along with their addresses, wishlists and associated data. Created orders and their payment/shipping information (addresses) and reviews are not deleted.
|
|
583
|
+
# @name deleteCustomer
|
|
584
|
+
DELETE {{baseUrl}}/account/customer HTTP/1.1
|
|
585
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
586
|
+
|
|
587
|
+
###
|
|
588
|
+
|
|
589
|
+
# Delete an address of a customer
|
|
590
|
+
# Delete an address of customer.
|
|
591
|
+
#
|
|
592
|
+
# Only addresses which are not set as default addresses for shipping or billing can be deleted. You can check the current default addresses of your customer using the profile information endpoint and change them using the default address endpoint.
|
|
593
|
+
#
|
|
594
|
+
# **A customer must have at least one address (which can be used for shipping and billing).**
|
|
595
|
+
#
|
|
596
|
+
# An automatic fallback is not applied.
|
|
597
|
+
# @name deleteCustomerAddress
|
|
598
|
+
DELETE {{baseUrl}}/account/address/{addressId} HTTP/1.1
|
|
599
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
600
|
+
|
|
601
|
+
###
|
|
602
|
+
|
|
603
|
+
# Modify an address of a customer
|
|
604
|
+
# Modifies an existing address of a customer.
|
|
605
|
+
# @name updateCustomerAddress
|
|
606
|
+
PATCH {{baseUrl}}/account/address/{addressId} HTTP/1.1
|
|
607
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
608
|
+
Content-Type: application/json
|
|
609
|
+
|
|
610
|
+
{}
|
|
611
|
+
|
|
612
|
+
###
|
|
613
|
+
|
|
614
|
+
# Fetch addresses of a customer
|
|
615
|
+
# Lists all addresses of the current customer and allows filtering them based on a criteria.
|
|
616
|
+
# @name listAddress
|
|
617
|
+
POST {{baseUrl}}/account/list-address HTTP/1.1
|
|
618
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
619
|
+
Content-Type: application/json
|
|
620
|
+
|
|
621
|
+
{}
|
|
622
|
+
|
|
623
|
+
###
|
|
624
|
+
|
|
625
|
+
# Log in a customer
|
|
626
|
+
# Logs in customers given their credentials.
|
|
627
|
+
# @name loginCustomer
|
|
628
|
+
POST {{baseUrl}}/account/login HTTP/1.1
|
|
629
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
630
|
+
Content-Type: application/json
|
|
631
|
+
|
|
632
|
+
{
|
|
633
|
+
"username": "string",
|
|
634
|
+
"password": "string"
|
|
635
|
+
}
|
|
636
|
+
|
|
637
|
+
###
|
|
638
|
+
|
|
639
|
+
# Imitate the log in as a customer
|
|
640
|
+
# Imitate the log in as a customer given a generated token.
|
|
641
|
+
# @name imitateCustomerLogin
|
|
642
|
+
POST {{baseUrl}}/account/login/imitate-customer HTTP/1.1
|
|
643
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
644
|
+
Content-Type: application/json
|
|
645
|
+
|
|
646
|
+
{
|
|
647
|
+
"token": "string",
|
|
648
|
+
"customerId": "string",
|
|
649
|
+
"userId": "string"
|
|
650
|
+
}
|
|
651
|
+
|
|
652
|
+
###
|
|
653
|
+
|
|
654
|
+
# Log out a customer
|
|
655
|
+
# Logs out a customer.
|
|
656
|
+
# @name logoutCustomer
|
|
657
|
+
POST {{baseUrl}}/account/logout HTTP/1.1
|
|
658
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
659
|
+
|
|
660
|
+
###
|
|
661
|
+
|
|
662
|
+
# Confirm a customer registration
|
|
663
|
+
# Confirms a customer registration when double opt-in is activated.
|
|
664
|
+
#
|
|
665
|
+
# Learn more about double opt-in registration in our guide "Register a customer".
|
|
666
|
+
# @name registerConfirm
|
|
667
|
+
POST {{baseUrl}}/account/register-confirm HTTP/1.1
|
|
668
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
669
|
+
Content-Type: application/json
|
|
670
|
+
|
|
671
|
+
{
|
|
672
|
+
"hash": "string",
|
|
673
|
+
"em": "string"
|
|
674
|
+
}
|
|
675
|
+
|
|
676
|
+
###
|
|
677
|
+
|
|
678
|
+
# Register a customer
|
|
679
|
+
# Registers a customer. Used both for normal customers and guest customers.See the Guide "Register a customer" for more information on customer registration.
|
|
680
|
+
# @name register
|
|
681
|
+
POST {{baseUrl}}/account/register HTTP/1.1
|
|
682
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
683
|
+
Content-Type: application/json
|
|
684
|
+
|
|
685
|
+
{
|
|
686
|
+
"email": "string",
|
|
687
|
+
"password": "string",
|
|
688
|
+
"salutationId": "string",
|
|
689
|
+
"firstName": "string",
|
|
690
|
+
"lastName": "string",
|
|
691
|
+
"acceptedDataProtection": false,
|
|
692
|
+
"storefrontUrl": "string",
|
|
693
|
+
"billingAddress": null,
|
|
694
|
+
"shippingAddress": null,
|
|
695
|
+
"guest": false,
|
|
696
|
+
"birthdayDay": 0,
|
|
697
|
+
"birthdayMonth": 0,
|
|
698
|
+
"birthdayYear": 0,
|
|
699
|
+
"title": "string",
|
|
700
|
+
"affiliateCode": "string",
|
|
701
|
+
"campaignCode": "string"
|
|
702
|
+
}
|
|
703
|
+
|
|
704
|
+
###
|
|
705
|
+
|
|
706
|
+
# Reset a password with recovery credentials
|
|
707
|
+
# This operation is Step 2 of the password reset flow. It is required to conduct Step 1 "Send a password recovery mail" in order to obtain the required credentials for this step.Resets a customer's password using credentials from a password recovery mail as a validation.
|
|
708
|
+
# @name recoveryPassword
|
|
709
|
+
POST {{baseUrl}}/account/recovery-password-confirm HTTP/1.1
|
|
710
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
711
|
+
Content-Type: application/json
|
|
712
|
+
|
|
713
|
+
{
|
|
714
|
+
"hash": "string",
|
|
715
|
+
"newPassword": "string",
|
|
716
|
+
"newPasswordConfirm": "string"
|
|
717
|
+
}
|
|
718
|
+
|
|
719
|
+
###
|
|
720
|
+
|
|
721
|
+
# Send a password recovery mail
|
|
722
|
+
# This operation is Step 1 of the password reset flow. Make sure to implement Step 2 "Reset password with recovery credentials" in order to allow for the complete flow in your application. Sends a recovery mail containing a link with credentials that allows a customer to reset their password.
|
|
723
|
+
# @name sendRecoveryMail
|
|
724
|
+
POST {{baseUrl}}/account/recovery-password HTTP/1.1
|
|
725
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
726
|
+
Content-Type: application/json
|
|
727
|
+
|
|
728
|
+
{
|
|
729
|
+
"email": "string",
|
|
730
|
+
"storefrontUrl": "string"
|
|
731
|
+
}
|
|
732
|
+
|
|
733
|
+
###
|
|
734
|
+
|
|
735
|
+
# Change a customer's default shipping address
|
|
736
|
+
# Updates the default (preselected) shipping addresses of a customer.
|
|
737
|
+
# @name defaultShippingAddress
|
|
738
|
+
PATCH {{baseUrl}}/account/address/default-shipping/{addressId} HTTP/1.1
|
|
739
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
740
|
+
|
|
741
|
+
###
|
|
742
|
+
|
|
743
|
+
# Change a customer's default billing address
|
|
744
|
+
# Updates the default (preselected) billing addresses of a customer.
|
|
745
|
+
# @name defaultBillingAddress
|
|
746
|
+
PATCH {{baseUrl}}/account/address/default-billing/{addressId} HTTP/1.1
|
|
747
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
748
|
+
|
|
749
|
+
###
|
|
750
|
+
|
|
751
|
+
# Create a new address for a customer
|
|
752
|
+
# Creates a new address for a customer.
|
|
753
|
+
# @name createCustomerAddress
|
|
754
|
+
POST {{baseUrl}}/account/address HTTP/1.1
|
|
755
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
756
|
+
Content-Type: application/json
|
|
757
|
+
|
|
758
|
+
{}
|
|
759
|
+
|
|
760
|
+
###
|
|
761
|
+
|
|
762
|
+
# Fetch a breadcrumb
|
|
763
|
+
# Perform search to get category or product breadcrumb.
|
|
764
|
+
#
|
|
765
|
+
# Experimental API, not part of our backwards compatibility promise, thus this API can introduce breaking changes at any time.
|
|
766
|
+
# @name readBreadcrumb
|
|
767
|
+
GET {{baseUrl}}/breadcrumb/{id} HTTP/1.1
|
|
768
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
769
|
+
|
|
770
|
+
###
|
|
771
|
+
|
|
772
|
+
# Get OpenAPI Specification
|
|
773
|
+
# Get information about the store API in OpenAPI format.
|
|
774
|
+
# @name api-info
|
|
775
|
+
GET {{baseUrl}}/_info/openapi3.json HTTP/1.1
|
|
776
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
777
|
+
|
|
778
|
+
###
|
|
779
|
+
|
|
780
|
+
# Fetch and resolve a CMS page
|
|
781
|
+
# Loads a content management page by its identifier and resolve the slot data. This could be media files, product listing and so on.
|
|
782
|
+
#
|
|
783
|
+
# **Important notice**
|
|
784
|
+
#
|
|
785
|
+
# The criteria passed with this route also affects the listing, if there is one within the cms page.
|
|
786
|
+
# @name readCms
|
|
787
|
+
POST {{baseUrl}}/cms/{id} HTTP/1.1
|
|
788
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
789
|
+
Content-Type: application/json
|
|
790
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
791
|
+
|
|
792
|
+
{}
|
|
793
|
+
|
|
794
|
+
###
|
|
795
|
+
|
|
796
|
+
# Fetch countries
|
|
797
|
+
# Perform a filtered search for countries
|
|
798
|
+
# @name readCountry
|
|
799
|
+
POST {{baseUrl}}/country HTTP/1.1
|
|
800
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
801
|
+
Content-Type: application/json
|
|
802
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
803
|
+
|
|
804
|
+
{}
|
|
805
|
+
|
|
806
|
+
###
|
|
807
|
+
|
|
808
|
+
# Fetch registration settings for customer group
|
|
809
|
+
# @name getCustomerGroupRegistrationInfo
|
|
810
|
+
GET {{baseUrl}}/customer-group-registration/config/{customerGroupId} HTTP/1.1
|
|
811
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
812
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
813
|
+
|
|
814
|
+
###
|
|
815
|
+
|
|
816
|
+
# Download generated document
|
|
817
|
+
# Returns blob file of a generated document to download.
|
|
818
|
+
# @name download
|
|
819
|
+
POST {{baseUrl}}/document/download/{documentId}/{deepLinkCode} HTTP/1.1
|
|
820
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
821
|
+
Content-Type: application/json
|
|
822
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
823
|
+
|
|
824
|
+
{}
|
|
825
|
+
|
|
826
|
+
###
|
|
827
|
+
|
|
828
|
+
# Generate JWT token for app system backend
|
|
829
|
+
# Generate JWT token for authenticated communication with the app server
|
|
830
|
+
# @name generateJWTAppSystemAppServer
|
|
831
|
+
POST {{baseUrl}}/app-system/{name}/generate-token HTTP/1.1
|
|
832
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
833
|
+
Content-Type: application/json
|
|
834
|
+
|
|
835
|
+
{}
|
|
836
|
+
|
|
837
|
+
###
|
|
838
|
+
|
|
839
|
+
# Confirm a newsletter registration
|
|
840
|
+
# You have to use the hash from the link sent out via email to confirm the user registration.
|
|
841
|
+
# @name confirmNewsletter
|
|
842
|
+
POST {{baseUrl}}/newsletter/confirm HTTP/1.1
|
|
843
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
844
|
+
Content-Type: application/json
|
|
845
|
+
|
|
846
|
+
{
|
|
847
|
+
"hash": "string",
|
|
848
|
+
"em": "string"
|
|
849
|
+
}
|
|
850
|
+
|
|
851
|
+
###
|
|
852
|
+
|
|
853
|
+
# Create or remove a newsletter subscription
|
|
854
|
+
# This route is used to create/remove/confirm a newsletter subscription.
|
|
855
|
+
#
|
|
856
|
+
# The `option` property controls what should happen:
|
|
857
|
+
# * `direct`: The subscription is directly active and does not need a confirmation.
|
|
858
|
+
# * `subscribe`: An email will be send to the provided email address containing a link to the /newsletter/confirm route.
|
|
859
|
+
# The subscription is only successful, if the /newsletter/confirm route is called with the generated hashes.
|
|
860
|
+
# * `unsubscribe`: The email address will be removed from the newsletter subscriptions.
|
|
861
|
+
# * `confirmSubscribe`: Confirms the newsletter subscription for the provided email address.
|
|
862
|
+
# @name subscribeToNewsletter
|
|
863
|
+
POST {{baseUrl}}/newsletter/subscribe HTTP/1.1
|
|
864
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
865
|
+
Content-Type: application/json
|
|
866
|
+
|
|
867
|
+
{
|
|
868
|
+
"email": "string",
|
|
869
|
+
"option": "string",
|
|
870
|
+
"storefrontUrl": "string",
|
|
871
|
+
"salutationId": "string",
|
|
872
|
+
"firstName": "string",
|
|
873
|
+
"lastName": "string",
|
|
874
|
+
"street": "string",
|
|
875
|
+
"city": "string",
|
|
876
|
+
"zipCode": "string",
|
|
877
|
+
"tags": "string",
|
|
878
|
+
"languageId": "string",
|
|
879
|
+
"customFields": "string"
|
|
880
|
+
}
|
|
881
|
+
|
|
882
|
+
###
|
|
883
|
+
|
|
884
|
+
# Remove a newsletter subscription
|
|
885
|
+
# Removes a newsletter recipient from the mailing lists.
|
|
886
|
+
# @name unsubscribeToNewsletter
|
|
887
|
+
POST {{baseUrl}}/newsletter/unsubscribe HTTP/1.1
|
|
888
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
889
|
+
Content-Type: application/json
|
|
890
|
+
|
|
891
|
+
{
|
|
892
|
+
"email": "string"
|
|
893
|
+
}
|
|
894
|
+
|
|
895
|
+
###
|
|
896
|
+
|
|
897
|
+
# Fetch a list of categories
|
|
898
|
+
# Perform a filtered search for categories.
|
|
899
|
+
# @name readCategoryList
|
|
900
|
+
POST {{baseUrl}}/category HTTP/1.1
|
|
901
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
902
|
+
Content-Type: application/json
|
|
903
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
904
|
+
|
|
905
|
+
{}
|
|
906
|
+
|
|
907
|
+
###
|
|
908
|
+
|
|
909
|
+
# Fetch a single category
|
|
910
|
+
# This endpoint returns information about the category, as well as a fully resolved (hydrated with mapping values) CMS page, if one is assigned to the category. You can pass slots which should be resolved exclusively.
|
|
911
|
+
# @name readCategory
|
|
912
|
+
POST {{baseUrl}}/category/{navigationId} HTTP/1.1
|
|
913
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
914
|
+
Content-Type: application/json
|
|
915
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
916
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
917
|
+
|
|
918
|
+
{}
|
|
919
|
+
|
|
920
|
+
###
|
|
921
|
+
|
|
922
|
+
# Fetch currencies
|
|
923
|
+
# Perform a filtered search for currencies.
|
|
924
|
+
# @name readCurrency
|
|
925
|
+
POST {{baseUrl}}/currency HTTP/1.1
|
|
926
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
927
|
+
Content-Type: application/json
|
|
928
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
929
|
+
|
|
930
|
+
{}
|
|
931
|
+
|
|
932
|
+
###
|
|
933
|
+
|
|
934
|
+
# Fetch shipping methods
|
|
935
|
+
# Perform a filtered search for shipping methods.
|
|
936
|
+
# @name readShippingMethod
|
|
937
|
+
POST {{baseUrl}}/shipping-method HTTP/1.1
|
|
938
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
939
|
+
Content-Type: application/json
|
|
940
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
941
|
+
|
|
942
|
+
{}
|
|
943
|
+
|
|
944
|
+
###
|
|
945
|
+
|
|
946
|
+
# Cancel an order
|
|
947
|
+
# Cancels an order. The order state will be set to 'cancelled'.
|
|
948
|
+
# @name cancelOrder
|
|
949
|
+
POST {{baseUrl}}/order/state/cancel HTTP/1.1
|
|
950
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
951
|
+
Content-Type: application/json
|
|
952
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
953
|
+
|
|
954
|
+
{
|
|
955
|
+
"orderId": "string"
|
|
956
|
+
}
|
|
957
|
+
|
|
958
|
+
###
|
|
959
|
+
|
|
960
|
+
# Fetch a list of orders
|
|
961
|
+
# List orders of a customer.
|
|
962
|
+
# @name readOrder
|
|
963
|
+
POST {{baseUrl}}/order HTTP/1.1
|
|
964
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
965
|
+
Content-Type: application/json
|
|
966
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
967
|
+
|
|
968
|
+
{}
|
|
969
|
+
|
|
970
|
+
###
|
|
971
|
+
|
|
972
|
+
# Update the payment method of an order
|
|
973
|
+
# Changes the payment method of a specific order. You can use the /order route to find out if the payment method of an order can be changed - take a look at the `paymentChangeable`- array in the response.
|
|
974
|
+
# @name orderSetPayment
|
|
975
|
+
POST {{baseUrl}}/order/payment HTTP/1.1
|
|
976
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
977
|
+
Content-Type: application/json
|
|
978
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
979
|
+
|
|
980
|
+
{
|
|
981
|
+
"paymentMethodId": "string",
|
|
982
|
+
"orderId": "string"
|
|
983
|
+
}
|
|
984
|
+
|
|
985
|
+
###
|
|
986
|
+
|
|
987
|
+
# Download a purchased file
|
|
988
|
+
# Download a file included in the given order and with the given id. Access must be granted.
|
|
989
|
+
# @name orderDownloadFile
|
|
990
|
+
GET {{baseUrl}}/order/download/{orderId}/{downloadId} HTTP/1.1
|
|
991
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
992
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
993
|
+
|
|
994
|
+
###
|
|
995
|
+
|
|
996
|
+
# Fetch salutations
|
|
997
|
+
# Perform a filtered search for salutations.
|
|
998
|
+
# @name readSalutation
|
|
999
|
+
POST {{baseUrl}}/salutation HTTP/1.1
|
|
1000
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
1001
|
+
Content-Type: application/json
|
|
1002
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
1003
|
+
|
|
1004
|
+
{}
|
|
1005
|
+
|
|
1006
|
+
###
|
|
1007
|
+
|
|
1008
|
+
# Search for products (suggest)
|
|
1009
|
+
# Can be used to implement search previews or suggestion listings, that don’t require any interaction.
|
|
1010
|
+
# @name searchSuggest
|
|
1011
|
+
POST {{baseUrl}}/search-suggest HTTP/1.1
|
|
1012
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
1013
|
+
Content-Type: application/json
|
|
1014
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
1015
|
+
|
|
1016
|
+
{}
|
|
1017
|
+
|
|
1018
|
+
###
|
|
1019
|
+
|
|
1020
|
+
# Fetch a single product by SEO URL with cross-selling and custom fields
|
|
1021
|
+
# This route is used to load a single product with the corresponding details using its SEO URL. In addition to loading the data, this route fetches cross-selling products and custom field labels.
|
|
1022
|
+
# @name readCustomProductDetail
|
|
1023
|
+
POST {{baseUrl}}/novu/headless/product/{{seoUrl}} HTTP/1.1
|
|
1024
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
1025
|
+
Content-Type: application/json
|
|
1026
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
1027
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
1028
|
+
|
|
1029
|
+
{}
|
|
1030
|
+
|
|
1031
|
+
###
|
|
1032
|
+
|
|
1033
|
+
# Fetch a compact product listing by SEO URL
|
|
1034
|
+
# Fetches a product listing for a specific category identified by SEO URL. It also provides filters, sortings and property aggregations, similar to the standard product-listing endpoint, but includes the complete category data in the response.
|
|
1035
|
+
# @name readCompactProductListing
|
|
1036
|
+
@seoUrl = Food/Sweets/
|
|
1037
|
+
POST {{baseUrl}}/novu/headless/product-listing/{{seoUrl}} HTTP/1.1
|
|
1038
|
+
Sw-access-key: {{OPENAPI_ACCESS_KEY}}
|
|
1039
|
+
Content-Type: application/json
|
|
1040
|
+
Sw-Include-Seo-Urls: {{swIncludeSeoUrls}}
|
|
1041
|
+
Sw-Language-Id: {{swLanguageId}}
|
|
1042
|
+
|
|
1043
|
+
{}
|