Renommer ou archiver une catégorie
/v1/categories/{id}
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 champdetailsliste chaque erreur. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique 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êteRetry-After.
Une question ? contact@wanapos.com
