Kart FiyatKartFiyat API

GraphQL v3

Ş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

Yayındaki şema yalnızca katalog sorgularını içerir. Şemanın tamamını uç noktaya bir IntrospectionQuery göndererek doğrulayabilirsiniz.

graphql
type Query {
  categories(game: String, market: String, parentId: ID, first: Int, after: String): 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
}

Planlanan alanlar — henüz yayında değil

Aşağıdaki sorgular ve tüm Mutation alanları tasarım aşamasındadır; yayındaki şema bunları bildirmez. Pazar işlemleri (teklifler, soru-cevap, dışa aktarma) eklendiğinde bu bölüm güncellenecek.

graphql
# Planlanan sorgular
  listingQuestions(listingId: ID!): [ListingQuestion!]!
  myOffers(status: String, first: Int, after: String): OfferConnection!
  highlightCredits: Int!
  orderExports(first: Int): OrderExportConnection!

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

  # Alıcı teklifleri (Plus)
  createOffer(listingId: ID!, amount: Float!): OfferResult!
  counterOffer(offerId: ID!, amount: Float!): OfferResult!
  acceptOffer(offerId: ID!): OfferResult!
  rejectOffer(offerId: ID!): OfferResult!

  # İlan soru-cevap
  askListingQuestion(listingId: ID!, question: String!): ListingQuestionResult!
  answerListingQuestion(questionId: ID!, answer: String!): ListingQuestionResult!

  # Sipariş dışa aktarma (Plus)
  requestOrderExport(scope: OrderExportScope!): OrderExportResult!
}

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ı

graphql
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
OfferConnectionnodes, pageInfoTeklif listesi
OrderExportConnectionnodes, pageInfoDışa aktarma işleri listesi

Pazar İşlemi Türleri

Offer — Alıcı Teklifi

AlanTipAçıklama
idID!Teklif kimliği
listingListingTeklifin yapıldığı ilan
amountFloat!Teklif tutarı (TL)
statusString!pending, countered, accepted, rejected, expired, converted, invalidated
lastProposedByString!Son teklifi yapan taraf: buyer veya seller
expiresAtStringTeklifin son geçerlilik anı (24 saat)
acceptedAtStringKabul anı
rejectedAtStringRed anı
convertedAtStringSiparişe dönüşme anı
convertedOrderIdIDDönüşen sipariş kimliği

ListingQuestion — İlan Soru-Cevap

AlanTipAçıklama
idID!Soru kimliği
listingIdID!Sorunun ait olduğu ilan
questionString!Soru metni
answerStringCevap metni (cevaplanmadıysa null)
statusString!approved veya pending
answeredAtStringCevap zamanı

OrderExportJob — Dışa Aktarma İşi

AlanTipAçıklama
idID!İş kimliği
statusString!queued, processing, completed, failed
totalRowsIntDışa aktarılacak kayıt sayısı
downloadUrlStringİndirme bağlantısı (tamamlanınca)
createdAtStringOluşturulma zamanı

Giriş Türleri

graphql
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
}

# Dışa aktarma kapsamı: satış veya alış tarafındaki siparişler
enum OrderExportScope {
  SALES
  PURCHASES
}

# Teklif işlemi sonuç türleri
type OfferResult {
  offer: Offer!
  message: String
}

type ListingQuestionResult {
  question: ListingQuestion!
  message: String
}

type OrderExportResult {
  job: OrderExportJob!
  message: String
}

İ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.

graphql
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 }
    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.