ကုန်ပစ္စည်းစာရင်း API လမ်းကြောင်းများ

ကုန်ပစ္စည်းစာရင်းကို အဆင့်သုံးဆင့်ဖြင့် စီထားပါသည်။ ပင်မအမျိုးအစားအောက်တွင် အမျိုးအစားများ၊ အမျိုးအစားအောက်တွင် အမျိုးအစားခွဲများ ရှိပြီး အမျိုးအစားခွဲသည် အမှန်တကယ် ဝယ်ယူမည့် ပစ္စည်း ဖြစ်ပါသည်။ ဤလမ်းကြောင်းများဖြင့် ထိုအဆင့်ဆင့်ဖွဲ့စည်းပုံကို ကိုယ်ပိုင် database ထဲသို့ ကူးယူထားနိုင်ပြီး အော်ဒါမတင်မီ ပစ္စည်းတစ်ခု၏ ဈေးနှုန်းကို ချက်ချင်း စစ်ဆေးနိုင်ပါသည်။

GET

/catalog/big-categories

ပင်မအမျိုးအစား စာရင်း

ပင်မအမျိုးအစား အားလုံးကို ရယူပါ (ဥပမာ Mobile ဂိမ်း၊ PC ဂိမ်း၊ Gift Card)။

တောင်းဆိုနှုန်း ကန့်သတ်ချက်အကောင့်တစ်ခုလျှင် 5000 req / 60s (ပစ္စည်းစာရင်း endpoint အားလုံး ပေါင်းတွက်)

မေးမြန်းချက် (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 (ပစ္စည်းစာရင်း endpoint အားလုံး ပေါင်းတွက်)

မေးမြန်းချက် (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 (ပစ္စည်းစာရင်း endpoint အားလုံး ပေါင်းတွက်)

မှတ်ချက်: 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

ပစ္စည်း ဈေးနှုန်း ရယူခြင်း

အမျိုးအစားခွဲ/ပစ္စည်းတစ်ခု၏ လက်ရှိ လျှော့ပြီးဈေးနှုန်းကို ရယူပါ။ ကျသင့်ငွေ အတိအကျ သိရန် အော်ဒါမတင်မီ ဤ endpoint ကို အသုံးပြုပါ။

တောင်းဆိုနှုန်း ကန့်သတ်ချက်အကောင့်တစ်ခုလျှင် 5000 req / 60s (ပစ္စည်းစာရင်း endpoint အားလုံး ပေါင်းတွက်)

မှတ်ချက်: 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

အမျိုးအစား လိုအပ်ချက်များ ရယူခြင်း

အမျိုးအစားတစ်ခုအတွက် ၎င်းနှင့်သက်ဆိုင်သော လိုအပ်ချက် field များကို ရယူပါ။ ကစားသူ စစ်ဆေးခြင်း သို့မဟုတ် အော်ဒါတင်ခြင်း ပြုလုပ်ရာတွင် မည်သည့်အချက်အလက် လိုအပ်သည်ကို ဤ field များက ဖော်ပြပါသည် (ဥပမာ Player ID၊ Server၊ Region)။

တောင်းဆိုနှုန်း ကန့်သတ်ချက်အကောင့်တစ်ခုလျှင် 5000 req / 60s (ပစ္စည်းစာရင်း endpoint အားလုံး ပေါင်းတွက်)

မှတ်ချက်: ပြန်ရလာသော အကွက်များဖြင့် ကစားသူ အကောင့်စစ်ဆေးခြင်းနှင့် အော်ဒါ ဖန်တီးခြင်းအတွက် အလိုအလျောက် ပြောင်းလဲသော ဖောင်များကို တည်ဆောက်ပါ။ အကွက်တစ်ခုစီတွင် ၎င်း၏ data_type (text, number, single_select, multi_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"
      ]
    }
  ]
}

ဤစာမျက်နှာမှ တကယ့် တောင်းဆိုမှု ပို့ကြည့်ပါ

ဤလမ်းကြောင်းများကို တိုက်ရိုက်ခေါ်ဆို စမ်းသပ်ရန် API Key ကို ကူးထည့်ပါ။ ထည့်လိုက်သော Key ကို ယခုဖွင့်ထားသော browser tab ထဲတွင်သာ သိမ်းထားပြီး API ထံသို့သာ ပို့ပါသည်။

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

ခေါ်ဆိုမည့် API လမ်းကြောင်း ရွေးပါ

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.

ပလက်ဖောင်းကို စတင်အသုံးပြုသူ ဖြစ်ပါက Reseller များအတွက် ဂိမ်း Top Up API အကျဉ်းချုပ်၊ သို့မဟုတ် SHOP2TOPUP Reseller အစီအစဉ် အကျဉ်းချုပ် ကို ဖတ်၍ ပါတနာအကောင့် မည်သို့ အလုပ်လုပ်သည်ကို လေ့လာပါ။

ကုန်ပစ္စည်းစာရင်း API ရည်ညွှန်းချက်၊ ပင်မအမျိုးအစား၊ အမျိုးအစားနှင့် ဈေးနှုန်းများ