ক্যাটালগ এন্ডপয়েন্ট

ক্যাটালগ তিন স্তরের একটি ট্রি। বিগ ক্যাটাগরির ভেতরে থাকে ক্যাটাগরি, ক্যাটাগরির ভেতরে সাবক্যাটাগরি, আর সাবক্যাটাগরিই হলো সেই আইটেম যা আপনি আসলে কেনেন। এই এন্ডপয়েন্টগুলো দিয়ে পুরো ট্রি নিজের ডেটাবেসে মিরর করে রাখতে পারবেন, আর অর্ডার দেওয়ার ঠিক আগে যেকোনো আইটেমের দাম দেখে নিতে পারবেন।

GET

/catalog/big-categories

বিগ ক্যাটাগরির তালিকা

সব টপ-লেভেল ক্যাটাগরি দেখুন (যেমন মোবাইল গেম, পিসি গেম, গিফট কার্ড)।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট (ক্যাটালগের সব এন্ডপয়েন্ট মিলিয়ে)

কোয়েরি প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
for_uibooleanনারেসপন্সে ছবির URL-ও দেওয়া হবে।true
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/big-categories?for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "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

ক্যাটাগরির তালিকা

ক্যাটাগরিগুলো দেখুন, চাইলে বিগ ক্যাটাগরি দিয়ে ফিল্টারও করতে পারেন। প্রতিটি ক্যাটাগরি মানে একটি গেম বা সার্ভিস।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট (ক্যাটালগের সব এন্ডপয়েন্ট মিলিয়ে)

কোয়েরি প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
bigCategoryIdnumberনাবিগ ক্যাটাগরি ID দিয়ে ফিল্টার করুন।1
for_uibooleanনারেসপন্সে ছবির URL-ও দেওয়া হবে।true
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/categories?bigCategoryId=1&for_ui=true" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "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

সাবক্যাটাগরির তালিকা (প্রোডাক্ট)

যেসব প্রোডাক্ট/ডিনোমিনেশন পাওয়া যাচ্ছে, সেগুলো দেখুন। প্রতিটি সাবক্যাটাগরি কেনা যায় এমন একটি আইটেম।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট (ক্যাটালগের সব এন্ডপয়েন্ট মিলিয়ে)

নোট: product_type ফিল্ডে 'topup' থাকলে পণ্যটি সরাসরি প্লেয়ারের অ্যাকাউন্টে টপ আপ করা হয়; 'voucher' থাকলে পণ্যটি একটি কোড ডেলিভারি দেয়, অর্থাৎ এটি ভাউচার পণ্য। fulfillment_type (টপ আপের ক্ষেত্রে 'api', কোডের ক্ষেত্রে 'voucher') এবং returns_voucher (কোডের ক্ষেত্রে true) ফিল্ড দুটি এখন ডেপ্রিকেটেড, কারণ এরা কেবল product_type-এর একই তথ্য আবার দেখায়। রেসপন্সে id ফিল্ড থাকলে তার মান item_id-এর সমান হয়।

কোয়েরি প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
categoryIdnumberনাক্যাটাগরি ID দিয়ে ফিল্টার করুন।12
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategories?categoryId=12" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "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

আইটেমের দাম দেখুন

নির্দিষ্ট সাবক্যাটাগরি/আইটেমের বর্তমান ছাড়সহ দাম দেখুন। অর্ডার তৈরির আগে এটি দেখে নিলে ঠিক কত খরচ হবে তা জানতে পারবেন।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট (ক্যাটালগের সব এন্ডপয়েন্ট মিলিয়ে)

নোট: unit_price হলো প্রতি ইউনিটের জন্য আপনার কাছ থেকে যে দাম নেওয়া হবে। অর্ডার তৈরির সময় expected_unit_price ফিল্ডে ঠিক এই মানটিই দিন।

পাথ প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
itemIdnumberহ্যাঁসাবক্যাটাগরি/আইটেমের ID।999
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/subcategory/999/price" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "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

ক্যাটাগরির রিকোয়ারমেন্ট দেখুন

নির্দিষ্ট ক্যাটাগরির ডাইনামিক রিকোয়ারমেন্ট ফিল্ডগুলো দেখুন। প্লেয়ার যাচাই বা অর্ডার তৈরির সময় কী কী তথ্য লাগবে, এই ফিল্ডগুলো তা জানিয়ে দেয় (যেমন Player ID, সার্ভার, রিজিয়ন)।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট (ক্যাটালগের সব এন্ডপয়েন্ট মিলিয়ে)

নোট: ফেরত আসা ফিল্ডগুলো দিয়ে প্লেয়ার যাচাই আর অর্ডার তৈরির ডাইনামিক ফর্ম বানান। প্রতিটি ফিল্ডে তার data_type (text, number, single_select, multi_select) দেওয়া থাকে, আর select ফিল্ডে কোন কোন অপশন আছে তাও থাকে।

পাথ প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
categoryIdnumberহ্যাঁযে ক্যাটাগরির রিকোয়ারমেন্ট দরকার, তার ID।12
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/catalog/category/12/requirements" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "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"
      ]
    }
  ]
}

এই পেজ থেকেই আসল রিকোয়েস্ট পাঠান

এই এন্ডপয়েন্টগুলো লাইভ কল করতে একটি API key পেস্ট করুন। key এই ব্রাউজার ট্যাবেই থাকে এবং শুধু API-তেই পাঠানো হয়।

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

এন্ডপয়েন্ট বেছে নিন

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

ক্যাটালগ এক্সপ্লোরার

Catalog Explorer

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

Enter your API key above to browse the catalog.

প্ল্যাটফর্মে নতুন হলে রিসেলারদের জন্য গেম টপ আপ API ওভারভিউ, অথবা SHOP2TOPUP রিসেলার প্রোগ্রামের পরিচিতি পড়ে জেনে নিন পার্টনার অ্যাকাউন্ট কীভাবে কাজ করে।

ক্যাটালগ API রেফারেন্স: বিগ ক্যাটাগরি, ক্যাটাগরি, দাম