Classements

Renommer ou archiver une catégorie

PATCH /v1/categories/{id}
vpn_key Permission write_products Compte comme une écriture

Renomme ou archive une catégorie, et la renvoie après modification. Une catégorie ne change pas de parent.

La modification est partielle : seuls les champs envoyés changent. Il n'existe pas de suppression : pour retirer un élément, archivez-le avec archived à true. Les produits qui le portent le gardent.

Une catégorie qui a des sous-catégories en service ne peut pas être archivée : archivez d'abord ses sous-catégories. À l'inverse, on ne remet pas en service une catégorie dont le parent est archivé.

Un nom déjà pris est refusé avec l'erreur duplicate_name, qui donne l'identifiant existant : réutilisez-le plutôt que de créer un doublon. La comparaison ne tient compte ni des majuscules, ni des accents, ni des espaces autour, et inclut les éléments archivés.

Paramètres

id Obligatoire Identifiant de la catégorie (champ id).
dry_run Facultatif true pour tout vérifier sans rien enregistrer : la réponse est celle que vous auriez obtenue, avec meta.dry_run à true. L'identifiant renvoyé n'est alors pas réservé.
Idempotency-Key Facultatif Identifiant unique de votre choix (8 à 100 caractères). Si vous renvoyez la même requête avec le même identifiant, elle n'est pas exécutée deux fois : vous recevez la réponse d'origine. Recommandé pour toute création.

Corps JSON à envoyer

Champ Type Description
name texte Nom de la catégorie. De 2 à 50 caractères. Un nom déjà pris est refusé (duplicate_name), sans tenir compte des majuscules ni des accents.
id_parent entier À la création seulement : identifiant de la catégorie parente. Absent ou 0 pour une catégorie de premier niveau. Le parent ne peut pas être changé ensuite.
archived booléen À la modification seulement : true pour archiver, false pour remettre en service.

Exemple d'appel

curl -X PATCH "https://api.wanapos.com/v1/categories/12" \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Chemises et polos"}'

Réponse en cas de succès (statut 200)

La catégorie après modification.

Champ Type Description
data objet
data.id entier Identifiant de la catégorie. C'est la valeur de categories[].id dans un produit.
data.name texte Nom de la catégorie.
data.id_parent entier Identifiant de la catégorie parente. 0 pour une catégorie de premier niveau.
data.niveau entier Niveau dans l'arborescence, de 1 (racine) à 5.
data.chemin liste de texte Noms des catégories depuis la racine jusqu'à celle-ci, elle comprise. Exemple : ["Vêtements", "Homme", "Chemises"].
data.archived booléen true si la catégorie est archivée.
data.date_creation texte Date de création.
data.date_update texte Date de la dernière modification. Chaîne vide si inconnue.
meta objet
meta.request_id texte Identifiant de l'appel, à communiquer à l'assistance en cas de problème.
{
    "data": {
        "id": 12,
        "name": "Chemises",
        "id_parent": 5,
        "niveau": 3,
        "chemin": [
            "Vêtements",
            "Homme",
            "Chemises"
        ],
        "archived": false,
        "date_creation": "2026-03-14T10:22:00+01:00",
        "date_update": "2026-10-02T16:05:00+02:00"
    },
    "meta": {
        "request_id": "3f9a1c0b7d2e4a61"
    }
}

Erreurs possibles

  • 401 Clé absente, inconnue ou révoquée. Codes : missing_key, invalid_key.
  • 403 Appel refusé pour ce compte ou cette clé. Codes : api_not_activated, account_not_eligible, access_blocked, missing_scope.
  • 404 L'élément demandé n'existe pas sur ce compte. Code : resource_not_found.
  • 409 Ce nom est déjà porté par un autre élément du même classement. Code : duplicate_name. Le message et l'indication donnent l'identifiant existant. Rien n'a été enregistré.
  • 422 Données envoyées invalides. Code : validation_failed. Le champ details liste chaque erreur.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.
  • 503 Une autre écriture est en cours sur ce compte. Code : account_busy. Renvoyer la même requête après le délai de l'en-tête Retry-After.

Voir toutes les erreurs

Une question ? contact@wanapos.com