Kategoriler

Tüm ürün kategorilerini listeleyin ve kategori detaylarına erişin.

Profesyonel Plan Gerektirir

Kategori listeleme, detay ve ağaç yapısı endpoint'leri yalnızca Profesyonel planda kullanılabilir. Başlangıç planı ile bu endpoint'lere istek yapıldığında 403 PLAN_UPGRADE_REQUIRED hatası döner. Başlangıç planında kategori bilgisi yalnızca ürün yanıtlarındaki category alanı üzerinden erişilebilir.

GET /api/v1/categories

Tüm kategorileri listeler.

Query Parametreleri

Parametre	Tip	Zorunlu	Açıklama
game	string	Hayır	Oyun türüne göre filtrele (pokemon, onepiece)
market	string	Hayır	Pazara göre filtrele (pricecharting, cardmarket)
parent_id	integer	Hayır	Belirli bir üst kategorinin alt kategorilerini getir

Örnek İstek

curl -X GET "https://kartfiyat.com/api/v1/categories?game=pokemon" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
  "success": true,
  "data": [
    {
      "id": 1,
      "parent_id": null,
      "name": "Pokemon TCG",
      "slug": "pokemon-tcg",
      "image": "https://kartfiyat.com/storage/categories/pokemon.jpg",
      "release_date": "1996-10-20",
      "game": "pokemon",
      "market": "TR",
      "parent": null,
      "children": []
    }
  ]
}

GET /api/v1/categories/tree

Kategorileri hiyerarşik (ağaç) yapısında döner.

Örnek Yanıt

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Pokemon TCG",
      "slug": "pokemon-tcg",
      "children": [
        {
          "id": 10,
          "name": "Scarlet & Violet",
          "slug": "scarlet-violet",
          "children": [
            {
              "id": 101,
              "name": "Paldea Evolved",
              "slug": "paldea-evolved"
            }
          ]
        }
      ]
    }
  ]
}

GET /api/v1/categories/{id}

Belirli bir kategorinin detaylarını döner.

Path Parametreleri

Parametre	Tip	Açıklama
id	integer	Kategori ID'si

Örnek İstek

curl -X GET "https://kartfiyat.com/api/v1/categories/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
  "success": true,
  "data": {
    "id": 1,
    "parent_id": null,
    "name": "Pokemon TCG",
    "slug": "pokemon-tcg",
    "image": "https://kartfiyat.com/storage/categories/pokemon.jpg",
    "release_date": "1996-10-20",
    "game": "pokemon",
    "market": "TR",
    "parent": null,
    "children": [
      {
        "id": 10,
        "name": "Scarlet & Violet",
        "slug": "scarlet-violet"
      }
    ]
  }
}

GET /api/v1/categories/{id}/items

Belirli bir kategorideki tüm ürünleri listeler.

Query Parametreleri

Parametre	Tip	Varsayılan	Açıklama
search	string	-	Ürün adında arama
genre	string	-	Türe göre filtrele
sort_by	string	name	Sıralama alanı (name, created_at, updated_at)
sort_order	string	asc	Sıralama yönü (asc, desc)
per_page	integer	50	Sayfa başına ürün (max: 100)
page	integer	1	Sayfa numarası

Örnek Yanıt

{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Pikachu VMAX",
      "code": "SWSH045",
      "slug": "pikachu-vmax-swsh045",
      "images": [
        {
          "id": 1,
          "url": "https://kartfiyat.com/storage/items/pikachu-vmax.jpg",
          "order": 1
        }
      ],
      "prices": [
        {
          "label": "Near Mint",
          "price": 450.00,
          "updated_at": "2026-02-03T10:30:00Z"
        }
      ],
      "groups": [
        {
          "id": 1,
          "name": "Ungraded",
          "slug": "ungraded"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 156,
    "last_page": 4,
    "has_more": true
  },
  "category": {
    "id": 101,
    "name": "Paldea Evolved",
    "slug": "paldea-evolved"
  }
}