# Categorie

> Elenca le categorie del tuo catalogo

- Pagina: https://tbit.app/it/docs/api/categories
- URL base: `https://rest-api.tbit.app/v1`
- Autenticazione: header `X-API-Key` con la tua chiave in ogni richiesta (gli esempi la leggono dalla variabile d'ambiente `TBIT_API_KEY`)

## Panoramica

Le categorie sono facet derivati dai category_tags dei tuoi prodotti attivi. Ogni categoria include il numero di prodotti etichettati con essa. Usa il nome della categoria come parametro tag quando elenchi i prodotti.

## Endpoint

| Metodo | Percorso | Descrizione |
| --- | --- | --- |
| `GET` | `/v1/categories` | Elenca i facet di categoria |

## Elencare le categorie

`GET /v1/categories`

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

## Formato della risposta

Le categorie con il loro conteggio di prodotti, più il totale degli articoli attivi nel catalogo:

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