خرید گیفت کارت سریع و مطمئن

فهرست مستندات توسعه دهندگان

مستندات API: محصولات

نحوه دسته بندی و نمایش محصولات در گیفتی کارت

در ساختار محصولات فروشگاه گیفتی‌کارت، گیفت‌کارت‌ها در ۳ سطح سلسله‌مراتبی سازمان‌دهی می‌شوند تا مدیریت و یکپارچه‌سازی با سیستم‌های خارجی (از طریق API) را تسهیل کنند. در ادامه، توضیحات مختصر هر سطح همراه با نکات فنی مرتبط با API ارائه شده‌است:

۱. دسته‌بندی (Category)

  • تعریف: گروه‌بندی اصلی محصولات براساس برند یا سرویس (مانند گیفت‌کارت اپل، نتفلیکس، استیم).

  • مثال:

				
					[
  {
    "sku": "CATEGORY-SKU",
    "name": "نام دسته‌بندی",
    "count": 10,
    "permalink": "https://example.com/category",
    "thumbnail": "https://example.com/thumbnail.jpg"
  }
]

۲. محصولات (Products)

  • تعریف: نسخه‌های منطقه‌ای یا نوع‌خاصی از یک دسته‌بندی (مانند گیفت‌کارت اپل آمریکا، گیفت‌کارت نتفلیکس ترکیه).

  • مثال:

				
					{
  "total": 100,
  "page": 1,
  "page_size": 10,
  "products": [
    {
      "name": "نام محصول",
      "sku": "PRODUCT-SKU",
      "url": "https://example.com/product",
      "image_url": "https://example.com/image.jpg",
      "variant_count": 5
    }
  ]
}

۳. واریانت (Variant)

  • تعریف: محصول نهایی با مشخصات مقدار اعتبار و قیمت (مانند گیفت‌کارت اپل آمریکا ۵۰۰ دلار). این سطح همان چیزی است که کاربر نهایی خریداری می‌کند.

  • مثال:

				
					[
  {
    "sku": "VARIANT_SKU",
    "name": "نام واریانت",
    "url": "https://example.com/product/variant",
    "image_url": "https://example.com/image.jpg",
    "price": "100000",
    "price_currency": "IRR",
    "value": "مقدار واریانت",
    "max_order_per_item": 5,
    "stock_status": "instant"
  }
]
مستندات API: وضعیت حساب
مستندات API: لیست دسته‌بندی‌ها

جستجو در گیفتی کارت

منوی اصلی گیفتی کارت