Endpoint katalog

Katalog mempunyai tiga peringkat: kategori besar mengandungi kategori, dan setiap kategori mengandungi subkategori. Subkategori ialah item yang boleh dibeli. Endpoint ini membolehkan anda menyalin susunan tersebut ke pangkalan data sendiri dan menyemak harga item sejurus sebelum membuat pesanan.

GET

/catalog/big-categories

Senarai kategori besar

Dapatkan semua kategori peringkat atas (contohnya game mudah alih, game PC, kad hadiah).

Had kadar5000 permintaan / 60 saat setiap akaun (dikongsi oleh semua endpoint katalog)

Parameter query

Nama	Jenis	Wajib	Penerangan	Contoh
for_ui	boolean	Tidak	Sertakan URL imej dalam respons.	true

Permintaan

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

Contoh respons

{
  "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

Senarai kategori

Dapatkan senarai kategori, dengan pilihan untuk menapis mengikut kategori besar. Setiap kategori mewakili satu game atau perkhidmatan.

Had kadar5000 permintaan / 60 saat setiap akaun (dikongsi oleh semua endpoint katalog)

Parameter query

Nama	Jenis	Wajib	Penerangan	Contoh
bigCategoryId	number	Tidak	Tapis mengikut ID kategori besar.	1
for_ui	boolean	Tidak	Sertakan URL imej dalam respons.	true

Permintaan

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

Contoh respons

{
  "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

Senarai subkategori (produk)

Dapatkan produk/denominasi yang tersedia. Setiap subkategori ialah item yang boleh dibeli.

Had kadar5000 permintaan / 60 saat setiap akaun (dikongsi oleh semua endpoint katalog)

Nota: Nilai product_type ialah 'topup' bagi top up terus ke akaun pemain dan 'voucher' bagi produk yang menghantar kod. fulfillment_type ('api' untuk top up, 'voucher' untuk kod) dan returns_voucher (true untuk kod) sudah lapuk: kedua-duanya hanya mengulang product_type. Jika medan id ada, nilainya sama dengan item_id.

Parameter query

Nama	Jenis	Wajib	Penerangan	Contoh
categoryId	number	Tidak	Tapis mengikut ID kategori.	12

Permintaan

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

Contoh respons

{
  "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

Dapatkan harga item

Dapatkan harga semasa selepas diskaun bagi subkategori/item tertentu. Gunakan endpoint ini sebelum membuat pesanan supaya anda tahu kos sebenar.

Had kadar5000 permintaan / 60 saat setiap akaun (dikongsi oleh semua endpoint katalog)

Nota: Nilai unit_price ialah amaun yang akan dicaj kepada anda. Gunakan nilai ini untuk expected_unit_price semasa membuat pesanan.

Parameter laluan

Nama	Jenis	Wajib	Penerangan	Contoh
itemId	number	Ya	ID subkategori/item.	999

Permintaan

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

Contoh respons

{
  "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

Dapatkan keperluan kategori

Dapatkan medan keperluan dinamik bagi kategori tertentu. Medan ini menerangkan maklumat yang diperlukan semasa mengesahkan pemain atau membuat pesanan (contohnya ID pemain, server, region).

Had kadar5000 permintaan / 60 saat setiap akaun (dikongsi oleh semua endpoint katalog)

Nota: Gunakan medan yang dipulangkan untuk membina borang dinamik bagi pengesahan pemain dan pembuatan pesanan. Setiap medan menyatakan data_type (text, number, single_select, multi_select) serta pilihan yang tersedia untuk medan jenis pilihan.

Parameter laluan

Nama	Jenis	Wajib	Penerangan	Contoh
categoryId	number	Ya	ID kategori yang keperluannya ingin diambil.	12

Permintaan

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

Contoh respons

{
  "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"
      ]
    }
  ]
}

Hantar permintaan sebenar dari halaman ini

Tampal kunci API untuk memanggil endpoint ini secara langsung. Kunci itu kekal dalam tab pelayar ini dan hanya dihantar kepada API.

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

Pilih endpoint

Include images (for_ui=true)

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Penjelajah katalog

Catalog Explorer

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

Enter your API key above to browse the catalog.

Jika anda baru di platform ini, mulakan dengan gambaran keseluruhan API top up game untuk reseller, atau baca gambaran keseluruhan program reseller SHOP2TOPUP untuk mengetahui cara akaun rakan kongsi berfungsi.