API-overzicht
Wijzig het aantal op een winkelwagenregel
Kies een handeling voor het request, responsestructuur, toegangsregels en implementatiebron.
SchrijvenOpenbare winkelwagencontext
PATCH/api/v1/cart/{lineKey}
Wijzig het aantal op een winkelwagenregel
Deze route vereist geen auth:sanctum of bearer-bevoegdheid.
Verzoek
| Veld | In | Regel |
|---|---|---|
lineKey | Padparameter | Verplichte line_key uit de winkelwagen, niet product_id. Een onbekende sleutel betekent niet automatisch 404. |
X-Cart-Token | Header | Toegangssleutel voor de gastwinkelwagen, teruggegeven door de API. Bewaar deze; zonder geldig token ontstaat een nieuwe context. |
quantity | JSON-body | Verplichte integer, 0 tot 99. Nul verwijdert de regel. |
curl --request PATCH "https://shop.example.test/api/v1/cart/$LINE_KEY" \
--header 'Accept: application/json' \
--header "X-Cart-Token: $CART_TOKEN" \
--header 'Content-Type: application/json' \
--data '{"quantity":2}'Antwoord200
Succes: 200
Responsestructuur (notatie, geen opgenomen antwoord)
{ data: { token: string, item_count: integer, requires_shipping: boolean, subtotal_amount: integer|null, currency: string|null, lines: CartLine[] } }Responseheader: X-Cart-Token komt overeen met data.token.
Gebruikelijke fouten
| HTTP-status | Betekenis |
|---|---|
422 | validation_error: ongeldige invoer of niet-vervulde domeinvereisten. Betaalinitiatie kan ook payment_failed geven. |
429 | rate_limited: wacht voor een nieuwe poging, vooral bij schrijfverzoeken. |