نقاط الكتالوج

الكتالوج شجرة من ثلاثة مستويات: الفئات الكبرى تضمّ الفئات، والفئات تضمّ الفئات الفرعية، والفئة الفرعية هي العنصر الذي تشتريه فعلًا. تتيح لك هذه النقاط نسخ تلك الشجرة إلى قاعدة بياناتك وتسعير أي عنصر مباشرةً قبل طلبه.

GET

/catalog/big-categories

List Big Categories

Get all top-level categories (e.g., Mobile Games, PC Games, Gift Cards).

حدّ المعدل80 req / 60s per user (shared across all catalog endpoints)

معاملات الاستعلام

الاسمالنوعمطلوبالوصفمثال
for_uibooleanلاInclude image URLs in the response.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

List Categories

Get categories, optionally filtered by big category. Each category represents a game or service.

حدّ المعدل80 req / 60s per user (shared across all catalog endpoints)

معاملات الاستعلام

الاسمالنوعمطلوبالوصفمثال
bigCategoryIdnumberلاFilter by big category ID.1
for_uibooleanلاInclude image URLs in the response.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

List Subcategories (Products)

Get available products/denominations. Each subcategory is a purchasable item.

حدّ المعدل80 req / 60s per user (shared across all catalog endpoints)

معاملات الاستعلام

الاسمالنوعمطلوبالوصفمثال
categoryIdnumberلاFilter by category 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",
      "fulfillment_type": "api",
      "returns_voucher": false
    }
  ]
}
GET

/catalog/subcategory/:itemId/price

Get Item Price

Get the current discounted price for a specific subcategory/item. Use this before creating an order to know the exact cost.

حدّ المعدل80 req / 60s per user (shared across all catalog endpoints)

ملاحظة: The unit_price is what you will be charged. Use this value for expected_unit_price when creating orders.

معاملات المسار

الاسمالنوعمطلوبالوصفمثال
itemIdnumberنعمThe subcategory/item 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

Get Category Requirements

Get the dynamic requirement fields for a specific category. These fields describe what information is needed when validating a player or creating an order (e.g., player ID, server, region).

حدّ المعدل80 req / 60s per user (shared across all catalog endpoints)

ملاحظة: Use the returned fields to build dynamic forms for player validation and order creation. Each field specifies its data_type (text, number, single_select, multi_select) and available options for select fields.

معاملات المسار

الاسمالنوعمطلوبالوصفمثال
categoryIdnumberنعمThe category ID to get requirements for.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 لمناداة هذه النقاط مباشرةً. يبقى المفتاح في تبويب المتصفّح هذا ولا يُرسل إلا إلى الواجهة البرمجية نفسها.

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.

جديد على المنصة؟ ابدأ من نظرة عامة على واجهة شحن الألعاب للموزّعين، أو اقرأ نظرة عامة على برنامج موزّعي SHOP2TOPUP لمعرفة كيفية عمل حساب الشريك.

مرجع API الكتالوج — الفئات والفئات الفرعية والأسعار