API Produits

Creez, lisez, mettez a jour et supprimez des produits dans votre catalogue.

Endpoints

GET

/products

products:read

Obtenez une liste paginee de produits. Supporte le filtrage par statut, categorie et recherche.

GET

/products/:id

products:read

Obtenez un produit par son ID.

POST

/products

products:write

Creez un nouveau produit dans votre catalogue.

PUT

/products/:id

products:write

Mettez a jour un produit existant. Les mises a jour partielles sont supportees.

DELETE

/products/:id

products:write

Suppression douce d'un produit. Peut etre restaure sous 30 jours.

Reference des Champs

Champ	Type	Obligatoire	Description
id	string	Non	Identifiant unique du produit (lecture seule)
sku	string	Oui	Unite de gestion des stocks
name	string	Oui	Nom du produit
description	string	Non	Description du produit (HTML autorise)
barcode	string	Non	Code-barres principal du produit (UPC/EAN)
brand	string	Non	Nom de marque du produit
categoryId	string	Non	Identifiant de categorie
unitPrice	integer	Oui	Prix en centimes (ex. 1999 = $19.99)
normalPrice	integer	Non	Prix normal / catalogue en centimes (pour afficher les remises)
purchasePrice	integer	Non	Prix d'achat / coût en centimes
weight	string	Non	Poids en grammes
isActive	boolean	Non	Si le produit est actif / publié (par défaut : true)
stockTotal	integer	Non	Stock total disponible dans tous les entrepôts (lecture seule)
images	string[]	Non	URLs des images du produit
createdAt	datetime	Non	Horodatage ISO 8601 (lecture seule)
updatedAt	datetime	Non	Horodatage ISO 8601 (lecture seule)

Parametres de Requete (Liste)

Champ	Type	Obligatoire	Description
page	integer	Non	Numero de page (defaut : 1)
limit	integer	Non	Elements par page (defaut : 20, max : 100)

Exemple

Lister les produits avec pagination

bash

curl "https://api.mercozy.com/api/v1/external/products?page=1&limit=10" \
  -H "X-API-Key: mk_live_your_key_here"

Creer un produit

bash

curl -X POST "https://api.mercozy.com/api/v1/external/products" \
  -H "X-API-Key: mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "WDG-001",
    "name": "Premium Widget",
    "unitPrice": 2999,
    "normalPrice": 3999,
    "brand": "Acme Corp",
    "isActive": true
  }'