Lister les catégories
GET
/v1/categories
Permission read_products
Compte comme une lecture
Renvoie les catégories du compte, tous niveaux confondus, par identifiant croissant. Les catégories forment une arborescence de 5 niveaux au plus : chacune donne son parent (id_parent), son niveau et son chemin complet depuis la racine (chemin). Pour reconstruire l'arbre, parcourez toute la liste puis regroupez par id_parent.
Le parcours se fait par curseur : tant que meta.has_more vaut true, rappelez l'adresse avec after égal à meta.next_after. Les éléments archivés ne sont renvoyés qu'avec archived=true.
Paramètres
limit |
Facultatif | Nombre d'éléments par page, de 1 à 100. 50 par défaut. |
after |
Facultatif | Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur next_after de la réponse précédente. |
archived |
Facultatif | true pour inclure aussi les éléments archivés. false par défaut : seuls les éléments en service sont renvoyés. |
Exemple d'appel
curl "https://api.wanapos.com/v1/categories" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
Une page de catégories.
| Champ | Type | Description |
|---|---|---|
data |
liste | Une page, par identifiant croissant. Liste vide s'il n'y a rien. |
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. |
meta.count |
entier | Nombre d'éléments dans cette page. |
meta.has_more |
booléen |
true s'il reste une page à lire. |
meta.next_after |
entier |
Valeur à passer dans after pour la page suivante. 0 quand le parcours est terminé. |
{
"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",
"count": 1,
"has_more": false,
"next_after": 0
}
}
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. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
