API

Kategorien

Die Kategorien deines Katalogs auflisten

Überblick

Kategorien sind Facetten, die aus den category_tags deiner aktiven Produkte abgeleitet werden. Jede Kategorie enthält die Anzahl der Produkte, die damit gelabelt sind. Nutze den Kategorienamen als Parameter tag, wenn du Produkte auflistest.

Endpoints

Methode	Pfad	Beschreibung
GET	`/v1/categories`	Kategorie-Facetten auflisten

Kategorien auflisten

GET/v1/categories

curl "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);

Antwortformat

Die Kategorien mit ihrer Produktanzahl, plus die Gesamtzahl aktiver Artikel im Katalog:

json

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