API Categories

Gerez vos categories de produits avec prise en charge des hierarchies imbriquees.

Endpoints

GET

/categories

categories:read

Obtenir une liste plate de toutes les categories.

GET

/categories/tree

categories:read

Obtenir l'arbre complet des categories avec sous-categories imbriquees.

GET

/categories/:id

categories:read

Obtenir une categorie par son ID.

POST

/categories

categories:write

Creer une nouvelle categorie. Definissez parentId pour creer une sous-categorie.

PUT

/categories/:id

categories:write

Mettre a jour une categorie existante. Les mises a jour partielles sont prises en charge.

DELETE

/categories/:id

categories:write

Suppression douce d'une categorie. Les produits de cette categorie ne sont pas affectes.

Reference des Champs

Champ	Type	Obligatoire	Description
id	string	Non	Identifiant unique de la categorie (lecture seule)
name	string	Oui	Nom de la categorie
slug	string	Non	Slug convivial pour URL (genere automatiquement si omis)
description	string	Non	Description de la categorie
parentId	string	Non	ID de la categorie parente pour l'imbrication
imageUrl	string	Non	URL de l'image de la categorie
sortOrder	integer	Non	Ordre d'affichage (inferieur = premier)
isActive	boolean	Non	Si la categorie est active (defaut : true)
children	Category[]	Non	Sous-categories imbriquees (uniquement dans le endpoint arbre)
createdAt	datetime	Non	Horodatage ISO 8601 (lecture seule)
updatedAt	datetime	Non	Horodatage ISO 8601 (lecture seule)

Exemple

Obtenir l'arbre des categories

bash

curl "https://api.mercozy.com/api/v1/external/categories/tree" \
  -H "X-API-Key: mk_live_xxxxx"

Creer une categorie

bash

curl -X POST "https://api.mercozy.com/api/v1/external/categories" \
  -H "X-API-Key: mk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Electronics",
    "description": "Electronic devices and accessories",
    "sortOrder": 1,
    "isActive": true
  }'

Exemple de Reponse (Arbre)

json

{
  "data": [
    {
      "id": "cat_abc123",
      "name": "Electronics",
      "slug": "electronics",
      "description": "Electronic devices and accessories",
      "parentId": null,
      "imageUrl": null,
      "sortOrder": 1,
      "isActive": true,
      "children": [
        {
          "id": "cat_def456",
          "name": "Smartphones",
          "slug": "smartphones",
          "description": "Mobile phones",
          "parentId": "cat_abc123",
          "imageUrl": null,
          "sortOrder": 1,
          "isActive": true,
          "children": []
        }
      ],
      "createdAt": "2025-12-15T10:30:00Z",
      "updatedAt": "2025-12-15T10:30:00Z"
    }
  ]
}