GraphQL v3

Sorgular

Kategoriler ve ürünler için örnek GraphQL sorguları. Tümü tek uç noktaya POST ile gönderilir.

POST https://kartfiyat.com/api/v3/graphql

Profesyonel plan ve üzeri

Pazar fiyatları (kartfiyat, pricecharting, tcgmarket, cardmarket) ve kart veri alanları (rarity, illustrator, hp, types, dexIds, stage, evolveFrom, suffix, level) yalnızca Profesyonel plan ve üzerinde döner.

Yayında olan sorgular

Bu sayfadaki Kategoriler, Kategori Detayı, Kategorideki Ürünler, Ürün Arama ve Listeleme, Ürün Detayı, Pazar Fiyatları ve Tüm Verileri İsteme bölümleri yayındadır.

İlan Soru-Cevap, Tekliflerim, Öne Çıkarma Hakkı ve Sipariş Dışa Aktarma bölümleri planlanan alanlardır; henüz yayında değildir (şema bu alanları bildirmez).

Kategorileri Listele

graphql

query {
  categories(game: "pokemon") {
    nodes {
      id
      name
      slug
      image
      children { id name }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Kategori Detayı

graphql

query {
  category(id: 10) {
    id
    name
    slug
    parent { id name }
    children { id name slug }
  }
}

Kategorideki Ürünler

graphql

query {
  category(id: 10) {
    items(first: 20, search: "pikachu") {
      nodes {
        id
        name
        code
        prices { label price updatedAt }
      }
      pageInfo { hasNextPage endCursor }
    }
  }
}

Ürün Arama ve Listeleme

graphql

query {
  items(
    game: "pokemon"
    search: "charizard"
    first: 10
    sortBy: "name"
    sortOrder: "asc"
  ) {
    nodes {
      id
      name
      code
      category { id name slug }
      prices { label price }
    }
    pageInfo { hasNextPage endCursor }
  }
}

graphql

query {
  items(search: "charizard", first: 3) {
    nodes { id name code }
  }
}

Ürün Detayı

Ürünün temel bilgileri, tüm pazar fiyatları (market ile ayrışır) ve kart veri alanları.

graphql

query {
  item(id: 12345) {
    id
    name
    code
    slug
    genre
    game
    category { id name slug }
    images { url order }
    prices { market label price currency updatedAt }
    groups { id name }
    attributes { name value }

    # Kart veri alanları (Profesyonel+)
    rarity
    illustrator
    hp
    types
    dexIds
    stage
    evolveFrom
    suffix
    level
  }
}

Pazar Fiyatları

Bir ürünün tüm pazarlardaki fiyatları prices alanından gelir. Fiyatın hangi pazara ait olduğu market alanıyla belli olur: kartfiyat, pricecharting, tcgmarket, cardmarket. Yalnızca belirli bir pazarın fiyatını almak isterseniz sorguda filtreleyebilirsiniz:

graphql

query {
  item(id: 12345) {
    name
    prices(markets: [TCGMARKET, CARDMARKET]) {
      market
      label
      price
      currency
    }
  }
}

İlan Soru-Cevap

Bu alan henüz yayında değildir; planlanan sözleşmedir.

Bir ilandaki onaylı ve cevaplanmış soruları listeler. Herkese açıktır; kimlik doğrulama gerekmez.

graphql

query {
  listingQuestions(listingId: 5044) {
    id
    question
    answer
    answeredAt
  }
}

Tekliflerim (Alıcı)

Bu alan henüz yayında değildir; planlanan sözleşmedir.

Yaptığınız teklifleri listeler. Kimlik doğrulama + Plus gerekir. status ile filtreleyebilirsiniz (pending, accepted, rejected, expired).

graphql

query {
  myOffers(status: "pending", first: 20) {
    nodes {
      id
      amount
      status
      lastProposedBy
      expiresAt
      listing { id title price }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Öne Çıkarma Hakkı

Bu alan henüz yayında değildir; planlanan sözleşmedir.

Kalan öne çıkarma hakkınızı döner. Kimlik doğrulama + Plus gerekir.

graphql

query {
  highlightCredits
}

Sipariş Dışa Aktarma İşleri

Bu alan henüz yayında değildir; planlanan sözleşmedir.

Başlattığınız dışa aktarma işlerini ve indirme bağlantılarını listeler. Kimlik doğrulama + Plus gerekir.

graphql

query {
  orderExports(first: 20) {
    nodes {
      id
      status
      totalRows
      downloadUrl
      createdAt
    }
    pageInfo { hasNextPage endCursor }
  }
}

Tüm Verileri İsteme

İsteyebileceğiniz tüm alanları içeren örnek. İhtiyacınız olmayan alanları çıkarabilirsiniz; ayrıntılı liste için Şemasayfasındaki "İstenebilecek Tüm Veriler" bölümüne bakın.

graphql

query {
  item(id: 12345) {
    id
    name
    code
    slug
    genre
    game
    category { id name slug parent { id name } }
    images { url order }
    groups { id name }
    attributes { name value }
    prices { market label price currency updatedAt }
    rarity
    illustrator
    hp
    types
    dexIds
    stage
    evolveFrom
    suffix
    level
  }
}

Önemli Notlar

Planına bağlı alanlar (örn. images, attributes, genre) yalnızca uygun planda döner.
Sayfalama first/after imleçleri ile yapılır (cursor-based).
Bir alanı istemezsen sorguya ekleme; yanıtta yalnızca istediğin alanlar döner.

Sayfalama ve fiyat etiketleri hakkında ayrıntı için Şema ve Rate Limiting sayfalarına bakın.