# الفئات

> اعرض فئات كتالوجك

- الصفحة: https://tbit.app/ar/docs/api/categories
- عنوان URL الأساسي: `https://rest-api.tbit.app/v1`
- المصادقة: ترويسة `X-API-Key` تحمل مفتاحك في كل طلب (تقرأه الأمثلة من متغير البيئة `TBIT_API_KEY`)

## نظرة عامة

الفئات أوجه تصنيف مشتقة من category_tags في منتجاتك النشطة. تتضمن كل فئة عدد المنتجات الموسومة بها. استخدم اسم الفئة كمعامل tag عند عرض المنتجات.

## نقاط النهاية

| الطريقة | المسار | الوصف |
| --- | --- | --- |
| `GET` | `/v1/categories` | عرض أوجه الفئات |

## عرض الفئات

`GET /v1/categories`

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

## صيغة الاستجابة

الفئات مع عدد منتجات كل منها، إضافة إلى إجمالي العناصر النشطة في الكتالوج:

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