เอนด์พอยต์แคตตาล็อก

แค็ตตาล็อกเป็นโครงสร้างสามชั้น หมวดหมู่ใหญ่มีหมวดหมู่อยู่ภายใน หมวดหมู่มีหมวดหมู่ย่อย และหมวดหมู่ย่อยคือสินค้าที่ซื้อจริง ใช้ endpoint เหล่านี้คัดลอกโครงสร้างไปไว้ในฐานข้อมูลของคุณเอง และเช็กราคาสินค้าทันทีก่อนสั่งซื้อ

GET

/catalog/big-categories

รายการหมวดหมู่หลัก

ดึงรายการหมวดหมู่หลักทั้งหมด เช่น เกมมือถือ เกม PC และกิฟต์การ์ด

ขีดจำกัดการเรียกใช้5000 คำขอ / 60 วินาที ต่อบัญชี (ใช้โควตาร่วมกับทุก 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 คำขอ / 60 วินาที ต่อบัญชี (ใช้โควตาร่วมกับทุก 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 คำขอ / 60 วินาที ต่อบัญชี (ใช้โควตาร่วมกับทุก endpoint ของแคตตาล็อก)

หมายเหตุ: product_type เป็น 'topup' สำหรับการเติมเกมเข้าบัญชีผู้เล่นโดยตรง และเป็น 'voucher' สำหรับสินค้าที่ส่งเป็นโค้ด ส่วน fulfillment_type ('api' สำหรับการเติมเกม และ 'voucher' สำหรับโค้ด) กับ returns_voucher (true เมื่อเป็นโค้ด) เลิกใช้แล้ว (deprecated) เพราะเป็นแค่ค่าซ้ำของ 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 คำขอ / 60 วินาที ต่อบัญชี (ใช้โควตาร่วมกับทุก 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

ดูฟิลด์ที่ต้องกรอกตามหมวดหมู่

ดึงฟิลด์ข้อมูลแบบไดนามิกของหมวดหมู่ที่ระบุ ฟิลด์เหล่านี้บอกว่าต้องใช้ข้อมูลอะไรตอนตรวจสอบผู้เล่นหรือสร้างคำสั่งซื้อ (เช่น ID ผู้เล่น เซิร์ฟเวอร์ โซน)

ขีดจำกัดการเรียกใช้5000 คำขอ / 60 วินาที ต่อบัญชี (ใช้โควตาร่วมกับทุก 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 เพื่อเรียก endpoint เหล่านี้จริง คีย์จะอยู่ในแท็บเบราว์เซอร์นี้ และส่งไปที่ตัว 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 เพื่อดูว่าบัญชีพาร์ทเนอร์ใช้งานอย่างไร

เอกสารอ้างอิง Catalog API: หมวดหมู่ใหญ่ หมวดหมู่ และราคา