API Belgeleri

PokeTyphoons mağaza kataloğu, kimlik gerektirmeyen bir okuma API'si üzerinden sunulur. Kapalı kutu (sealed) ürünleri ve tekli Pokémon TCG kartlarını fiyat, stok ve alt kategori bilgisiyle sorgulayabilirsiniz.

Makine tarafından okunabilir tanım: OpenAPI 3.1 · Keşif: RFC 9727 API kataloğu

1. Temel Bilgiler

• Temel adres: https://poketyphoons.com
• Kimlik doğrulama yok; yalnız GET istekleri.
• Yanıtlar UTF-8 JSON. Fiyatlar Türk lirası (TRY).
• Hız sınırı: IP başına dakikada 120 istek (kısa süreli 40 istek tolerans).

2. Ürünleri Listeleme

GET /api/catalog/products

• category — POKEMON_BOXES, SINGLE_CARDS veya GRADED_CARDS
• type — alt kategori slug'ı (ör. booster-box, elite-trainer-box). Bir ürün birden çok tipe girebilir.
• inStock — true ile yalnız stoktakiler
• q — başlıkta arama; her kelime ayrı aranır, bitişiklik gerekmez
• page (1'den başlar) ve limit (varsayılan 24, en fazla 100)

Sıralama eklenme tarihine göre yeniden eskiye, eşitlikte slug'a göredir. Sayfalama offset tabanlıdır: iki istek arasında katalog değişirse bir ürün kayabilir.

GET https://poketyphoons.com/api/catalog/products?category=SINGLE_CARDS&inStock=true&limit=2

{
  "products": [
    {
      "slug": "charizard-ex-223-197",
      "url": "https://poketyphoons.com/products/charizard-ex-223-197",
      "title": "Charizard ex 223/197",
      "category": "SINGLE_CARDS",
      "productTypes": ["ex-kartlar"],
      "language": "EN",
      "price": { "amount": "1300.00", "currency": "TRY" },
      "compareAtPrice": null,
      "stock": 2,
      "availability": "in_stock",
      "earliestShipDate": null,
      "image": "https://poketyphoons.com/uploads/ornek.webp"
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 135,
  "totalPages": 68
}

3. Tek Ürün

GET /api/catalog/products/{slug}

Liste alanlarına ek olarak description, tüm images ve derecelendirilmiş kartlarda graded (gradingCompany, gradeValue, certNumber) döner. Yayında olmayan slug için 404.

4. Durum

GET /api/health → { "status": "ok" }

5. Kullanım Koşulları

Veriler mağazanın güncel kataloğudur ve haber vermeden değişebilir; bağlayıcı olan ürün sayfasındaki bilgidir. Yanıtlar 5 dakika önbelleklenebilir, bu süreden sık sorgulamak yeni veri getirmez. Sorularınız için iletişim sayfamıza yazabilirsiniz.