API
Categorie
Elenca le categorie del tuo catalogo
# 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 } } ```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.
| Metodo | Percorso | Descrizione |
|---|---|---|
| GET | /v1/categories | Elenca i facet di categoria |
/v1/categoriescurl "https://rest-api.tbit.app/v1/categories" \
-H "X-API-Key: $TBIT_API_KEY"const response = await fetch('https://rest-api.tbit.app/v1/categories', {
headers: {
'X-API-Key': process.env.TBIT_API_KEY,
},
});
const data = await response.json();import axios from 'axios';
const { data } = await axios.get(
'https://rest-api.tbit.app/v1/categories',
{
headers: {
'X-API-Key': process.env.TBIT_API_KEY,
},
},
);import os
import requests
response = requests.get(
'https://rest-api.tbit.app/v1/categories',
headers={'X-API-Key': os.environ['TBIT_API_KEY']},
)
data = response.json()<?php
$ch = curl_init('https://rest-api.tbit.app/v1/categories');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-API-Key: ' . getenv('TBIT_API_KEY'),
],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);Le categorie con il loro conteggio di prodotti, più il totale degli articoli attivi nel catalogo:
{
"data": {
"categories": [
{ "name": "fiestas", "count": 42 },
{ "name": "infantil", "count": 27 },
{ "name": "decoracion", "count": 18 }
],
"total_items": 134
}
}