API

Catégories

Listez les catégories de votre catalogue

Vue d'ensemble

Les catégories sont des facettes dérivées des category_tags de vos produits actifs. Chaque catégorie indique le nombre de produits qui la portent. Utilisez le nom de la catégorie comme paramètre tag pour lister les produits.

Endpoints

Méthode	Chemin	Description
GET	`/v1/categories`	Lister les facettes de catégorie

Lister les catégories

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

Format de réponse

Les catégories avec leur nombre de produits, plus le total d'articles actifs du catalogue :

json

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