# Basket Webservice / Update API

### 📝 Introduction

We offer a web service API for the automated processing of shopping carts. This allows for the subsequent adjustment of already existing baskets. For access, each user receives an Access Token and a User ID, which are provided via the frontend.

---

### 🔐 Authentication

The following headers are required to access the API:

<table data-path-to-node="7" id="bkmrk-header-description-t"><thead><tr><td>**Header**</td><td>**Description**</td><td>**Type**</td></tr></thead><tbody><tr><td><span data-path-to-node="7,1,0,0">**Content-Type**</span></td><td><span data-path-to-node="7,1,1,0">The Content-Type of the request</span></td><td><span data-path-to-node="7,1,2,0">String</span></td></tr><tr><td><span data-path-to-node="7,2,0,0">**X-Network-ID**</span></td><td><span data-path-to-node="7,2,1,0">Network ID: typically `-1` for cross-client (multi-tenant) API</span></td><td><span data-path-to-node="7,2,2,0">Integer</span></td></tr><tr><td><span data-path-to-node="7,3,0,0">**X-Auth-Token**</span></td><td><span data-path-to-node="7,3,1,0">Your Access Token (visible in the frontend)</span></td><td><span data-path-to-node="7,3,2,0">String</span></td></tr><tr><td><span data-path-to-node="7,4,0,0">**X-Auth-ID**</span></td><td><span data-path-to-node="7,4,1,0">Your User ID (visible in the frontend)</span></td><td><span data-path-to-node="7,4,2,0">Integer</span></td></tr></tbody></table>

---

### 📩 Endpoints

- **Admin:** `https://SUBDOMAIN.de/ws/V6/admin/JSON/Baskets`
- **Advertiser:** `https://SUBDOMAIN.de/ws/V6/advertiser/JSON/Baskets`

---

### 🧪 Example (cURL)

<div _ngcontent-ng-c1630465722="" class="code-block ng-tns-c1630465722-162 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-bash" jslog="223238;track:impression,attention;BardVeMetadataKey:[["r_a0358b217cddd7ed","c_5229d7aaa2a28b5d",null,"rc_b8bc6142e9f97b18",null,null,"en",null,1,null,null,1,0]]"><div _ngcontent-ng-c1630465722="" class="code-block-decoration header-formatted gds-title-s ng-tns-c1630465722-162 ng-star-inserted"></div><div _ngcontent-ng-c1630465722="" class="formatted-code-block-internal-container ng-tns-c1630465722-162"><div _ngcontent-ng-c1630465722="" class="animated-opacity ng-tns-c1630465722-162"></div></div></div>```
curl -X PUT -H "Content-Type: application/json" -H "X-Network-ID: -1" -H "X-Auth-Token: AUTH-TOKEN" -H "X-Auth-ID: USER-ID" -d '[{"basket_item_id": 76041, "amount": 2, "status": "0", "additional": {"variable1": "text", "variable2": 1}}]' https://SUB.DOMAIN.DE/ws/V6/admin/JSON/Baskets

```

<div _ngcontent-ng-c1630465722="" class="code-block ng-tns-c1630465722-162 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--4" jslog="223238;track:impression,attention;BardVeMetadataKey:[["r_a0358b217cddd7ed","c_5229d7aaa2a28b5d",null,"rc_b8bc6142e9f97b18",null,null,"en",null,1,null,null,1,0]]"><div _ngcontent-ng-c1630465722="" class="formatted-code-block-internal-container ng-tns-c1630465722-162"><div _ngcontent-ng-c1630465722="" class="animated-opacity ng-tns-c1630465722-162"></div></div></div>---

### 🧾 Body Parameters

<table data-path-to-node="13" id="bkmrk-parameter-descriptio"><thead><tr><td>**Parameter**</td><td>**Description**</td><td>**Data Type**</td><td>**Required**</td></tr></thead><tbody><tr><td><span data-path-to-node="13,1,0,0">**basket\_item\_id**</span></td><td><span data-path-to-node="13,1,1,0">Unique ID of the basket item</span></td><td><span data-path-to-node="13,1,2,0">Integer</span></td><td><span data-path-to-node="13,1,3,0">✅ Yes</span></td></tr><tr><td><span data-path-to-node="13,2,0,0">**amount**</span></td><td><span data-path-to-node="13,2,1,0">Quantity of the basket item</span></td><td><span data-path-to-node="13,2,2,0">Integer</span></td><td><span data-path-to-node="13,2,3,0">No</span></td></tr><tr><td><span data-path-to-node="13,3,0,0">**price**</span></td><td><span data-path-to-node="13,3,1,0">Net price of the basket item</span></td><td><span data-path-to-node="13,3,2,0">Float</span></td><td><span data-path-to-node="13,3,3,0">No</span></td></tr><tr><td><span data-path-to-node="13,4,0,0">**status**</span></td><td><span data-path-to-node="13,4,1,0">Status of the order: `0` = open, `1` = confirmed, `2` = canceled</span></td><td><span data-path-to-node="13,4,2,0">Integer</span></td><td><span data-path-to-node="13,4,3,0">✅ Yes</span></td></tr><tr><td><span data-path-to-node="13,5,0,0">**turnover**</span></td><td><span data-path-to-node="13,5,1,0">Order value in campaign currency</span></td><td><span data-path-to-node="13,5,2,0">Float</span></td><td><span data-path-to-node="13,5,3,0">✅ Yes</span></td></tr><tr><td><span data-path-to-node="13,6,0,0">**additional**</span></td><td><span data-path-to-node="13,6,1,0">Additional information regarding the basket item</span></td><td><span data-path-to-node="13,6,2,0">JSON</span></td><td><span data-path-to-node="13,6,3,0">No</span></td></tr></tbody></table>

---

### Example Request

**Headers:**

<div _ngcontent-ng-c1630465722="" class="code-block ng-tns-c1630465722-163 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-http" jslog="223238;track:impression,attention;BardVeMetadataKey:[["r_a0358b217cddd7ed","c_5229d7aaa2a28b5d",null,"rc_b8bc6142e9f97b18",null,null,"en",null,1,null,null,1,0]]"><div _ngcontent-ng-c1630465722="" class="code-block-decoration header-formatted gds-title-s ng-tns-c1630465722-163 ng-star-inserted"><span class="ng-tns-c1630465722-163">HTTP</span><div _ngcontent-ng-c1630465722="" class="buttons ng-tns-c1630465722-163 ng-star-inserted"><button aria-label="Code herunterladen" class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger download-button ng-tns-c1630465722-163 mat-unthemed ng-star-inserted"></button><button aria-label="Code kopieren" class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger copy-button ng-tns-c1630465722-163 mat-unthemed ng-star-inserted"></button></div></div><div _ngcontent-ng-c1630465722="" class="formatted-code-block-internal-container ng-tns-c1630465722-163"><div _ngcontent-ng-c1630465722="" class="animated-opacity ng-tns-c1630465722-163"></div></div></div>```
Content-Type: application/json
X-Network-ID: -1
X-Auth-Token: ACCESS-TOKEN
X-Auth-ID: USER-ID

```

<div _ngcontent-ng-c1630465722="" class="code-block ng-tns-c1630465722-163 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk--8" jslog="223238;track:impression,attention;BardVeMetadataKey:[["r_a0358b217cddd7ed","c_5229d7aaa2a28b5d",null,"rc_b8bc6142e9f97b18",null,null,"en",null,1,null,null,1,0]]"><div _ngcontent-ng-c1630465722="" class="formatted-code-block-internal-container ng-tns-c1630465722-163"><div _ngcontent-ng-c1630465722="" class="animated-opacity ng-tns-c1630465722-163"></div></div></div>**Body:**

<div _ngcontent-ng-c1630465722="" class="code-block ng-tns-c1630465722-164 ng-animate-disabled ng-trigger ng-trigger-codeBlockRevealAnimation" id="bkmrk-json" jslog="223238;track:impression,attention;BardVeMetadataKey:[["r_a0358b217cddd7ed","c_5229d7aaa2a28b5d",null,"rc_b8bc6142e9f97b18",null,null,"en",null,1,null,null,1,0]]"><div _ngcontent-ng-c1630465722="" class="code-block-decoration header-formatted gds-title-s ng-tns-c1630465722-164 ng-star-inserted"><span class="ng-tns-c1630465722-164">JSON</span><div _ngcontent-ng-c1630465722="" class="buttons ng-tns-c1630465722-164 ng-star-inserted"><button aria-label="Code herunterladen" class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger download-button ng-tns-c1630465722-164 mat-unthemed ng-star-inserted"></button><button aria-label="Code kopieren" class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger copy-button ng-tns-c1630465722-164 mat-unthemed ng-star-inserted"></button></div></div><div _ngcontent-ng-c1630465722="" class="formatted-code-block-internal-container ng-tns-c1630465722-164"><div _ngcontent-ng-c1630465722="" class="animated-opacity ng-tns-c1630465722-164"></div></div></div>```
[
    {
        "basket_item_id": 76041, 
        "amount": 1, 
        "status": "1", 
        "additional": {
            "variable1": "text", 
            "variable2": 1
        }
    }
]
```