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

List Big Categories

Get all top-level categories (e.g., Mobile Games, PC Games, Gift Cards).

Hız sınırı80 req / 60s per user (shared across all catalog endpoints)

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
for_ui	boolean	Hayır	Include image URLs in the response.	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

List Categories

Get categories, optionally filtered by big category. Each category represents a game or service.

Hız sınırı80 req / 60s per user (shared across all catalog endpoints)

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
bigCategoryId	number	Hayır	Filter by big category ID.	1
for_ui	boolean	Hayır	Include image URLs in the response.	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

List Subcategories (Products)

Get available products/denominations. Each subcategory is a purchasable item.

Hız sınırı80 req / 60s per user (shared across all catalog endpoints)

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
categoryId	number	Hayır	Filter by category ID.	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",
      "fulfillment_type": "api",
      "returns_voucher": false
    }
  ]
}

GET

/catalog/subcategory/:itemId/price

Get Item Price

Get the current discounted price for a specific subcategory/item. Use this before creating an order to know the exact cost.

Hız sınırı80 req / 60s per user (shared across all catalog endpoints)

Not: The unit_price is what you will be charged. Use this value for expected_unit_price when creating orders.

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
itemId	number	Evet	The subcategory/item ID.	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

Get Category Requirements

Get the dynamic requirement fields for a specific category. These fields describe what information is needed when validating a player or creating an order (e.g., player ID, server, region).

Hız sınırı80 req / 60s per user (shared across all catalog endpoints)

Not: Use the returned fields to build dynamic forms for player validation and order creation. Each field specifies its data_type (text, number, single_select, multi_select) and available options for select fields.

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
categoryId	number	Evet	The category ID to get requirements for.	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.