Şema

v3 GraphQL API'sinin kök türleri ve temel nesne türleri. Alan listesi kapsamlı olup değişebilir; her zaman güncel şemayı keşfederek doğrulayın.

Plan Kısıtları — Profesyonel ve üzeri
Pazar fiyatları (PriceCharting, TCGMarket, CardMarket) ve kart veri alanları (rarity, illustrator, hp, types, dexIds, stage, evolveFrom, suffix, level) yalnızca Profesyonel plan ve üzerinde döner. Başlangıç planı bu alanları sorgulayabilir ancak yanıt null gelir; erişim yoksa 403 PLAN_UPGRADE_REQUIRED döner.

Kök Türler

type Query {
  categories(game: String, market: String, parentId: ID): CategoryConnection!
  category(id: ID!): Category
  items(game: String, market: String, search: String,
         categoryId: ID, first: Int, after: String,
         sortBy: String, sortOrder: String): ItemConnection!
  item(id: ID!): Item
}

type Mutation {
  updateListingPrice(listingId: ID!, price: Float!): ListingResult
  updateListing(listingId: ID!, input: ListingInput!): ListingResult
  setListingStatus(listingId: ID!, action: String!): ListingResult
  addCollectionItem(collectionId: ID!, input: CollectionItemInput!): CollectionItemResult
  updateCollectionItem(collectionId: ID!, itemId: ID!, input: CollectionItemInput!): CollectionItemResult
  removeCollectionItem(collectionId: ID!, itemId: ID!): SimpleResult
  configureWebhook(input: WebhookInput!): Webhook
}

Nesne Türleri

Category

AlanTipAçıklama
idID!Kategori kimliği
nameString!Kategori adı
slugString!URL-dostu tanımlayıcı
imageStringKategori görseli
parentCategoryÜst kategori
children[Category!]Alt kategoriler
itemsItemConnectionKategorideki ürünler (sayfalamalı)

Item

Ürünün temel bilgileri, pazar fiyatları ve eşleşen market kartından gelen kart veri alanları. 🛡️ işaretli alanlar Profesyonel plan ve üzerinde döner.

AlanTipAçıklama
idID!Ürün kimliği
nameString!Ürün adı
codeStringÜrün kodu (set numarası)
slugStringURL-dostu tanımlayıcı
genreStringÜrün türü (single, card, sealed, bundle)
gameStringOyun (pokemon, onepiece)
categoryCategoryÜrünün kategorisi
images[ItemImage!]Ürün görselleri
prices[Price!]Tüm pazarlardaki durum bazlı fiyatlar
groups[ItemGroup!]Kondisyon/grup etiketleri
attributes[ItemAttribute!]Ek özellikler (rakip özellikler)
rarity 🛡️StringKart nadirlik seviyesi (örn. Ultra Rare)
illustrator 🛡️StringKart çizeri/illustrator adı
hp 🛡️IntCan puanı (HP)
types 🛡️[String!]Enerji/türler (örn. ["Fire", "Darkness"])
dexIds 🛡️[Int!]Pokédex numaraları
stage 🛡️StringEvrim aşaması (örn. Stage 2, VSTAR)
evolveFrom 🛡️StringÖnceki evrim (evolve from) adı
suffix 🛡️StringKart soneki (örn. EX, V, GX)
level 🛡️IntKart seviyesi (varsa)

Price — Pazar Fiyatları

prices alanı, market alanıyla hangi pazardan geldiğini belirtir. Bir ürün KartFiyat, PriceCharting, TCGMarket ve CardMarket fiyatlarını birlikte sunar.

AlanTipAçıklama
marketString!Fiyat kaynağı: kartfiyat, pricecharting, tcgmarket, cardmarket
labelString!Kondisyon etiketi (örn. Near Mint, Lightly Played, PSA 10)
priceFloatFiyat (currency biriminde)
currencyString!Para birimi (KartFiyat için TRY; diğer pazarlar kaynak para birimini kullanır)
updatedAtStringSon güncelleme zamanı (ISO 8601)

Market enum'ları

enum Market {
  KARTFIYAT
  PRICECHARTING
  TCGMARKET
  CARDMARKET
}

Sayfalama

TürAlanAçıklama
PageInfohasNextPage, endCursorSonraki sayfa var mı ve imleç
CategoryConnectionnodes, pageInfoKategori listesi
ItemConnectionnodes, pageInfoÜrün listesi

Giriş Türleri

input ListingInput {
  price: Float
  title: String
  description: String
  offersEnabled: Boolean
  minOfferPrice: Float
}

input CollectionItemInput {
  itemId: ID
  itemGroupTypeId: ID
  quantity: Int
  purchasePrice: Float
  salePrice: Float
  purchaseDate: String
  cardUniqId: String
  note: String
}

input WebhookInput {
  url: String!
  onSale: Boolean
  onExpire: Boolean
  isActive: Boolean
}

İstenebilecek Tüm Veriler

Aşağıdaki sorgu bir ürün için isteyebileceğiniz tüm alanları gösterir. GraphQL'de ihtiyacınız olmayan alanı sorguya yazmazsınız; yanıt yalnızca seçtiğiniz alanları döner. 🛡️ alanlar Profesyonel plan ve üzerinde doludur.

query {
  item(id: 12345) {
    # Temel bilgiler
    id
    name
    code
    slug
    genre
    game
    category { id name slug parent { id name } }
    images { url order }
    groups { id name slug }
    attributes { name value }

    # Pazar fiyatları (Profesyonel+)
    prices {
      market
      label
      price
      currency
      updatedAt
    }

    # Kart veri alanları (Profesyonel+, market kartı ile eşleşenler)
    rarity
    illustrator
    hp
    types
    dexIds
    stage
    evolveFrom
    suffix
    level
  }
}

Alan özeti

AlanGrupPlanAçıklama
id, name, code, slugTemelTümüKimlik ve tanımlama
genre, gameTemelTümüÜrün türü ve oyun
category, images, groups, attributesTemelTümüKategori, görsel, grup, özellik
pricesFiyatProfesyonel+KartFiyat, PriceCharting, TCGMarket, CardMarket
rarity, illustratorKart verisiProfesyonel+Nadirlik ve çizer
hp, types, levelKart verisiProfesyonel+Can, enerji türleri, seviye
dexIdsKart verisiProfesyonel+Pokédex numaraları
stage, evolveFrom, suffixKart verisiProfesyonel+Evrim aşaması, önceki evrim, sonek
Kendi şemanızı keşfedin
Üretimdeki güncel şemayı her zaman uç noktaya bir IntrospectionQuery göndererek doğrulayabilirsiniz. Bu sayfa, sık kullanılan türlerin özetidir ve değişebilir.