# Catégories

> Listez les catégories de votre catalogue

- Page: https://tbit.app/fr/docs/api/categories
- URL de base: `https://rest-api.tbit.app/v1`
- Authentification: en-tête `X-API-Key` avec votre clé dans chaque requête (les exemples la lisent depuis la variable d'environnement `TBIT_API_KEY`)

## Vue d'ensemble

Les catégories sont des facettes dérivées des category_tags de vos produits actifs. Chaque catégorie indique le nombre de produits qui la portent. Utilisez le nom de la catégorie comme paramètre tag pour lister les produits.

## Endpoints

| Méthode | Chemin | Description |
| --- | --- | --- |
| `GET` | `/v1/categories` | Lister les facettes de catégorie |

## Lister les catégories

`GET /v1/categories`

```bash
curl "https://rest-api.tbit.app/v1/categories" \
  -H "X-API-Key: $TBIT_API_KEY"
```

## Format de réponse

Les catégories avec leur nombre de produits, plus le total d'articles actifs du catalogue :

```json
{
  "data": {
    "categories": [
      { "name": "fiestas", "count": 42 },
      { "name": "infantil", "count": 27 },
      { "name": "decoracion", "count": 18 }
    ],
    "total_items": 134
  }
}
```