කැටලොග් එන්ඩ්පොයින්ට්

කැටලොග් එක මට්ටම් තුනක ගසකි: ප්‍රධාන කාණ්ඩ තුළ කාණ්ඩ ඇති අතර, කාණ්ඩ තුළ උප කාණ්ඩ ඇත. ඔබ ඇත්තටම මිලදී ගන්නේ උප කාණ්ඩයයි. මෙම endpoints මගින් එම ගස ඔබේම database එකට පිටපත් කර ගැනීමටත්, ඇණවුම් කිරීමට මොහොතකට පෙර item එකක මිල බලා ගැනීමටත් හැකිය.

GET

/catalog/big-categories

ප්‍රධාන කාණ්ඩ ලැයිස්තුව

ඉහළම මට්ටමේ කාණ්ඩ සියල්ල ලබාගන්න (උදා: මොබයිල් ගේම්, PC ගේම්, ගිෆ්ට් කාඩ්).

ඉල්ලීම් සීමාවගිණුමකට 5000 req / 60s (සියලුම කැටලොග් endpoints එකම සීමාව බෙදා ගනී)

විමසුම් (query) පරාමිතීන්

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
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

කාණ්ඩ ලැයිස්තුව

කාණ්ඩ ලබා ගන්න. අවශ්‍ය නම් ප්‍රධාන කාණ්ඩය අනුව පෙරා ගත හැක. සෑම කාණ්ඩයක්ම ගේම් එකක් හෝ සේවාවක් නියෝජනය කරයි.

ඉල්ලීම් සීමාවගිණුමකට 5000 req / 60s (සියලුම කැටලොග් endpoints එකම සීමාව බෙදා ගනී)

විමසුම් (query) පරාමිතීන්

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
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

උප කාණ්ඩ ලැයිස්තුව (නිෂ්පාදන)

ලබාගත හැකි නිෂ්පාදන/වටිනාකම් ලබා ගන්න. සෑම උප කාණ්ඩයක්ම මිලදී ගත හැකි අයිතමයකි.

ඉල්ලීම් සීමාවගිණුමකට 5000 req / 60s (සියලුම කැටලොග් endpoints එකම සීමාව බෙදා ගනී)

සටහන: ප්ලේයර් ගිණුමකට සෘජුවම ටොප් අප් කරන නිෂ්පාදනයක් නම් product_type අගය 'topup' වේ. කෝඩ් එකක් ලබාදෙන වවුචරයක් නම් එම අගය 'voucher' වේ. fulfillment_type (ටොප් අප් එකකට 'api', කෝඩ් එකකට 'voucher') සහ returns_voucher (කෝඩ් එකක් නම් true) යන ක්ෂේත්‍ර දෙක අත්හැරීමට නියමිතයි. ඒවා කරන්නේ product_type හි දැනටමත් ඇති තොරතුරම නැවත පෙන්වීම පමණයි. id නමින් ක්ෂේත්‍රයක් තිබේ නම්, එහි අගය item_id අගයට සමානයි.

විමසුම් (query) පරාමිතීන්

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
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

අයිතමයේ මිල ලබා ගන්න

යම් උප කාණ්ඩයක/අයිතමයක වත්මන් වට්ටම් මිල ලබා ගන්න. ගෙවිය යුතු නිවැරදි මුදල දැන ගැනීමට ඇණවුම සෑදීමට පෙර මෙය භාවිත කරන්න.

ඉල්ලීම් සීමාවගිණුමකට 5000 req / 60s (සියලුම කැටලොග් endpoints එකම සීමාව බෙදා ගනී)

සටහන: unit_price යනු එක් ඒකකයකට ඔබෙන් අය කෙරෙන මිලයි. ඇණවුම් සාදන විට expected_unit_price ක්ෂේත්‍රයට මෙම අගයම ලබාදෙන්න.

මාර්ග (path) පරාමිතීන්

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
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, සර්වර්, කලාපය).

ඉල්ලීම් සීමාවගිණුමකට 5000 req / 60s (සියලුම කැටලොග් endpoints එකම සීමාව බෙදා ගනී)

සටහන: ලැබෙන ක්ෂේත්‍ර භාවිත කර ක්‍රීඩක තහවුරු කිරීමට සහ ඇණවුම් සෑදීමට ගතික පෝරම සකසන්න. සෑම ක්ෂේත්‍රයක්ම තම data_type (text, number, single_select, multi_select) දක්වයි. select ක්ෂේත්‍ර සඳහා ලබාගත හැකි විකල්පද එහි ඇත.

මාර්ග (path) පරාමිතීන්

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
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"
      ]
    }
  ]
}

මෙම පිටුවෙන්ම සැබෑ request එකක් යවන්න

මෙම එන්ඩ්පොයින්ට් සජීවීව ඇමතීමට ඔබේ API 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.

Platform එකට අලුත් නම් මුලින්ම රීසෙලර්ලා සඳහා ගේම් ටොප් අප් API හැඳින්වීම, නැතහොත් SHOP2TOPUP රීසෙලර් වැඩසටහනේ හැඳින්වීම කියවා පාර්ට්නර් ගිණුම ක්‍රියා කරන ආකාරය දැනගන්න.

කැටලොග් API යොමුව: ප්‍රධාන කාණ්ඩ, කාණ්ඩ, මිල