Katalog uç noktaları

Katalog üç seviyeli bir ağaçtır: büyük kategoriler kategorileri, kategoriler alt kategorileri barındırır ve alt kategori de asıl satın aldığınız kalemdir. Bu uç noktalar, ağacı kendi veritabanınıza yansıtmanızı ve siparişten hemen önce bir kalemi fiyatlandırmanızı sağlar.

GET

/catalog/big-categories

Ana Kategorileri Listele

Tüm üst düzey kategorileri getir (ör. Mobil Oyunlar, PC Oyunları, Hediye Kartları).

Hız sınırıHesap başına 5000 istek / 60 sn (tüm katalog endpoint'leri bu limiti ortak kullanır)

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
for_ui	boolean	Hayır	Yanıta görsel URL'lerini ekler.	true

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/big-categories?for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "success": true,
  "big_categories": [
    {
      "id": 1,
      "name": "Mobile Games",
      "description": "Popular mobile game top-ups"
    },
    {
      "id": 2,
      "name": "PC Games",
      "description": "PC game credits and items"
    }
  ]
}

GET

/catalog/categories

Kategorileri Listele

Kategorileri getir, istersen ana kategoriye göre filtrele. Her kategori bir oyunu ya da hizmeti temsil eder.

Hız sınırıHesap başına 5000 istek / 60 sn (tüm katalog endpoint'leri bu limiti ortak kullanır)

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
bigCategoryId	number	Hayır	Ana kategori ID'sine göre filtreler.	1
for_ui	boolean	Hayır	Yanıta görsel URL'lerini ekler.	true

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/categories?bigCategoryId=1&for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "success": true,
  "categories": [
    {
      "id": 12,
      "name": "Free Fire",
      "description": "Garena Free Fire diamonds",
      "big_category_id": 1,
      "big_category_name": "Mobile Games"
    }
  ]
}

GET

/catalog/subcategories

Alt Kategorileri Listele (Ürünler)

Satıştaki ürünleri ve paketleri getir. Her alt kategori satın alınabilen bir üründür.

Hız sınırıHesap başına 5000 istek / 60 sn (tüm katalog endpoint'leri bu limiti ortak kullanır)

Not: product_type, oyuncu hesabına doğrudan yükleme yapan ürünlerde 'topup', kod teslim eden ürünlerde 'voucher' değerini alır. fulfillment_type (yükleme için 'api', kod için 'voucher') ve returns_voucher (kod için true) kullanımdan kaldırıldı: ikisi de sadece product_type bilgisini tekrarlar. Bir id alanı varsa değeri item_id ile aynıdır.

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
categoryId	number	Hayır	Kategori ID'sine göre filtrele.	12

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategories?categoryId=12" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "success": true,
  "subcategories": [
    {
      "item_id": 999,
      "name": "FF 100 Diamonds",
      "description": "100 Free Fire Diamonds",
      "category_id": 12,
      "category_name": "Free Fire",
      "price": "0.99",
      "product_type": "topup",
      "fulfillment_type": "api",
      "returns_voucher": false
    }
  ]
}

GET

/catalog/subcategory/:itemId/price

Ürün Fiyatını Getir

Belirli bir alt kategori/ürünün güncel indirimli fiyatını al. Sipariş oluşturmadan önce tam olarak ne ödeyeceğini görmek için bunu kullan.

Hız sınırıHesap başına 60 sn'de 5000 istek (tüm katalog uç noktalarında ortak)

Not: Senden kesilecek tutar unit_price değeridir. Sipariş oluştururken expected_unit_price için bu değeri kullan.

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
itemId	number	Evet	Alt kategori/ürün ID'si.	999

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategory/999/price" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "success": true,
  "price": {
    "item_id": 999,
    "item_name": "FF 100 Diamonds",
    "unit_price": "0.950000",
    "currency": "USD",
    "original_price": "0.990000",
    "discount_applied": true,
    "timestamp": "2024-06-15T12:00:00Z"
  }
}

GET

/catalog/category/:categoryId/requirements

Kategori Gereksinimlerini Getir

Belirli bir kategorinin dinamik gereksinim alanlarını al. Bu alanlar, oyuncu doğrularken veya sipariş oluştururken hangi bilgilerin gerektiğini gösterir (ör. oyuncu ID'si, sunucu, bölge).

Hız sınırıHesap başına 60 sn'de 5000 istek (tüm katalog uç noktalarında ortak)

Not: Dönen alanlarla oyuncu doğrulama ve sipariş oluşturma için dinamik formlar hazırla. Her alan kendi data_type değerini (text, number, single_select, multi_select) ve seçim alanları için mevcut seçenekleri belirtir.

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
categoryId	number	Evet	Gereksinimlerini almak istediğin kategorinin ID'si.	12

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/catalog/category/12/requirements" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "success": true,
  "requirements": [
    {
      "field_name": "player_id",
      "data_type": "text",
      "placeholder": "Enter player ID"
    },
    {
      "field_name": "server",
      "data_type": "single_select",
      "placeholder": "Select server",
      "select_options": [
        "Asia",
        "Europe",
        "America"
      ]
    }
  ]
}

Bu sayfadan gerçek bir istek gönderin

Bu uç noktaları canlı çağırmak için bir API anahtarı yapıştırın. Anahtar bu tarayıcı sekmesinde kalır ve yalnızca API'nin kendisine gönderilir.

Enter your API key to use the interactive playground. Get your API key

Bir uç nokta seçin

Include images (for_ui=true)

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Katalog gezgini

Catalog Explorer

Browse the product hierarchy and copy IDs for use in API calls.

Enter your API key above to browse the catalog.

Platformda yeni misiniz? bayiler için oyun yükleme API'sine genel bakış ile başlayın veya SHOP2TOPUP bayi programına genel bakış sayfasından iş ortağı hesabının nasıl çalıştığını okuyun.