> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxanaut.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajouter un article au panier



## OpenAPI

````yaml /openapi.fr.json post /v1/store/cart/items
openapi: 3.0.0
info:
  title: OneSubnet Core API
  description: >-
    OneSubnet hosting panel API. Toutes les routes sont préfixées par /v1/
    (versioning URI). Les routes Panel sont appelées par le daemon Wings, pas
    par les clients. Les routes Admin nécessitent le rôle admin.
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: Auth & Users
    description: Authentification, profil, gestion utilisateurs
  - name: Store
    description: 'Boutique: catégories, produits, panier'
  - name: Billing
    description: Facturation, checkout Stripe, webhooks
  - name: Services
    description: Services hébergés (enregistrements facturation)
  - name: Affiliation
    description: Parrainage et commissions
  - name: Notifications
    description: Notifications
  - name: Admin - RBAC
    description: Gestion des rôles, permissions, groupes
  - name: Admin - Store & Invoices
    description: CRUD produits, plans, coupons, factures
  - name: Admin - Settings & Tenants
    description: Configuration, multi-tenant, whitelabel
  - name: Admin - Audit
    description: Journal d'audit des requêtes
  - name: System
    description: Health, meta-info
paths:
  /v1/store/cart/items:
    post:
      tags:
        - Store
      summary: Ajouter un article au panier
      operationId: CartController_addItem_v1
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddCartItemDto'
      responses:
        '201':
          description: ''
      security:
        - bearer: []
components:
  schemas:
    AddCartItemDto:
      type: object
      properties:
        productSku:
          type: string
          example: mc-java-paper
          description: SKU of the Product (or legacy Offer) to add to the cart.
        quantity:
          type: number
          example: 1
          minimum: 1
          maximum: 100
          default: 1
        planId:
          type: string
          description: >-
            ID of the billing Plan to use. When omitted, the product base price
            (or the first active plan, if the product has plans) is used.
        eggId:
          type: string
          description: >-
            Selected egg variant (software choice). Must be the product default
            egg or one of its eggVariants.
        configs:
          type: object
          description: >-
            Selected config options keyed by configOptionId → chosen value
            (matching a choice `value` in the option's `choices` JSON array).
            Each selection adds its `priceDeltaCents` to the unit price.
          example:
            ram: '4096'
            disk: '50'
      required:
        - productSku
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Boutique et panier](/panel/boutique.md)
- [Retirer un article du panier](/api-reference/store/retirer-un-article-du-panier.md)
- [Modifier un article du panier](/api-reference/store/modifier-un-article-du-panier.md)
- [Payer tout le panier (multi-articles)](/api-reference/billing/payer-tout-le-panier-multi-articles.md)
- [Envoyer un lien de paiement au client (admin)](/api-reference/admin--store-&-invoices/envoyer-un-lien-de-paiement-au-client-admin.md)