API

Categorieën

Bekijk de categorieën van je catalogus

Overzicht

Categorieën zijn facetten die worden afgeleid uit de category_tags van je actieve producten. Elke categorie bevat het aantal producten met dat label. Gebruik de naam van de categorie als parameter tag wanneer je producten opvraagt.

Endpoints

Methode	Pad	Beschrijving
GET	`/v1/categories`	Categoriefacetten opvragen

Categorieën opvragen

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

Responseformaat

De categorieën met hun aantal producten, plus het totaal aantal actieve artikelen in de catalogus:

json

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