@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.
@@ -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
+ {}