# Categorias

> Liste as categorias do seu catálogo

- Página: https://tbit.app/pt/docs/api/categories
- URL base: `https://rest-api.tbit.app/v1`
- Autenticação: cabeçalho `X-API-Key` com a sua chave em cada requisição (os exemplos a leem da variável de ambiente `TBIT_API_KEY`)

## Visão geral

As categorias são facetas derivadas das category_tags dos seus produtos ativos. Cada categoria inclui o número de produtos marcados com ela. Use o nome da categoria como parâmetro tag ao listar produtos.

## Endpoints

| Método | Rota | Descrição |
| --- | --- | --- |
| `GET` | `/v1/categories` | Listar as facetas de categoria |

## Listar categorias

`GET /v1/categories`

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

## Formato da resposta

As categorias com a contagem de produtos, mais o total de itens ativos no catálogo:

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