Classements

Lister les catégories

GET /v1/categories
vpn_key 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 champ field nomme le paramètre.
  • 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.

Voir toutes les erreurs

Une question ? contact@wanapos.com