Документация API товаров

Публичный API каталога товаров (только чтение) для реселлеров и партнёров.

В этом справочнике описаны публичные JSON-поля (только для чтения), на которых работают карточки товаров, страницы описаний, фильтры категорий, индикаторы наличия и локализованные тарифы в VND/USD на EmpireX. Персональные данные не передаются.

1. Быстрый старт

Запрашивайте активные позиции каталога через эндпоинты списков для отрисовки витринных карточек с обложками, локализованными заголовками, ценами в VND/USD, скидками и статусом наличия.

GET /api/accounts

GET /api/services

GET /api/products/{id-or-slug}

2. API списка каталога

GET /api/accounts?page=1&limit=20&sort=price&order=asc&locale=ru&category_id=cat-ai-tools

Параметр	Описание	Пример
category_id	Фильтрация товаров по ID категории витрины	cat-ai-tools
sort	Поле сортировки: view_count, created_at или price	price
order	Направление сортировки: asc или desc	asc
page	Номер страницы (начиная с 1)	1
limit	Количество элементов на странице (по умолчанию 20)	20
locale	Предпочтительная локаль ответа	ru

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "prod_chatgpt_plus",
        "slug": "chatgpt-plus-nang-cap-chinh-chu",
        "type": "account",
        "name_vi": "ChatGPT Plus - Nâng cấp chính chủ",
        "name_en": "ChatGPT Plus - Official Upgrade",
        "thumbnail": "https://empirex.org/images/chatgpt-plus.webp",
        "inventory_status": "in-stock",
        "categories": [
          {
            "category": {
              "id": "cat-ai-tools",
              "name_vi": "AI Tools",
              "name_en": "AI Tools",
              "slug": "ai-tools"
            }
          }
        ],
        "variants": [
          {
            "id": "var_1m",
            "name_vi": "Gói 1 tháng",
            "name_en": "1 Month",
            "price_vnd": 135000,
            "price_usd": 5.5,
            "original_price_vnd": 550000,
            "original_price_usd": 22,
            "stock": true,
            "is_default": true,
            "sku": "CGPT-PLUS-1M"
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 120,
      "totalPages": 6
    }
  }
}

3. API деталей товара

Используйте этот эндпоинт при открытии страницы отдельного товара для загрузки полного описания, галереи изображений, срока гарантии и условий доставки.

GET /api/products/chatgpt-plus-nang-cap-chinh-chu

{
  "success": true,
  "data": {
    "id": "prod_chatgpt_plus",
    "slug": "chatgpt-plus-nang-cap-chinh-chu",
    "type": "account",
    "name_vi": "ChatGPT Plus - Nâng cấp chính chủ",
    "name_en": "ChatGPT Plus - Official Upgrade",
    "description_vi": "Mô tả chi tiết đang hiển thị ở trang sản phẩm.",
    "description_en": "Product detail description shown on the product page.",
    "thumbnail": "https://empirex.org/images/chatgpt-plus.webp",
    "inventory_status": "in-stock",
    "delivery_type_vi": "Giao tài khoản thủ công",
    "delivery_type_en": "Manual account delivery",
    "vietnam_only": false,
    "variant_layout": "default",
    "images": [
      {
        "image_url": "https://empirex.org/images/chatgpt-plus-1.webp",
        "locale": "vi",
        "order_index": 1
      }
    ],
    "categories": [
      {
        "category": {
          "id": "cat-ai-tools",
          "name_vi": "AI Tools",
          "name_en": "AI Tools",
          "slug": "ai-tools"
        }
      }
    ],
    "variants": [
      {
        "id": "var_1m",
        "name_vi": "Gói 1 tháng",
        "name_en": "1 Month",
        "sku": "CGPT-PLUS-1M",
        "price_vnd": 135000,
        "price_usd": 5.5,
        "original_price_vnd": 550000,
        "original_price_usd": 22,
        "stock": true,
        "is_default": true,
        "warranty_duration": 1,
        "warranty_unit": "month",
        "image": "https://empirex.org/images/chatgpt-plus-variant.webp",
        "images": []
      }
    ]
  }
}

4. Поля схемы товара

id

Уникальный идентификатор товара для запроса деталей, корзины и оформления заказа.

slug

ЧПУ-идентификатор товара в URL, например /en/accounts/chatgpt-plus.

type

Тип маршрута каталога: account или service.

name_vi / name_en

Локализованные названия товара.

thumbnail

Основное изображение карточки в списках каталога.

inventory_status

Верхнеуровневый индикатор наличия на карточках и странице товара.

categories

Назначенные категории для фильтрации и группировки на витрине.

variants

Варианты подписки с ценами в VND и USD, старыми ценами, SKU и остатками.

description_vi / description_en

Локализованные форматированные описания для страницы товара.

images

Упорядоченная галерея изображений на странице товара.

delivery_type_vi / delivery_type_en

Локализованный способ выдачи, отображаемый в характеристиках товара.

warranty_duration / warranty_unit

Срок и единица измерения гарантии для каждого варианта.

vietnam_only

При значении true указывает, что активация или использование доступны только во Вьетнаме.

variant_layout

Режим отображения переключателя вариантов: default, matrix_2d или matrix_3d.

5. Значения статуса наличия

in-stock

Доступен для мгновенного добавления в корзину и оплаты.

low-stock

Осталось мало единиц; отображается метка малого остатка.

out-of-stock

Временно нет в наличии; кнопки покупки неактивны.

price = 0

Индивидуальный расчёт («По запросу»); стандартная кнопка покупки скрыта.