Docs da API de Produtos

API de Catálogo Somente Leitura para Revendedores e Parceiros.

Esta referência documenta os campos JSON públicos somente leitura que alimentam os cards de produtos, páginas de detalhes, filtros de categorias, selos de estoque e variantes em VND/USD na EmpireX. Nenhum dado privado é exposto.

1. Início Rápido

Busque itens ativos do catálogo pelos endpoints de listagem para renderizar cards de vitrine com miniaturas, títulos traduzidos, preços em VND/USD, descontos e disponibilidade.

GET /api/accounts

GET /api/services

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

2. API de Listagem do Catálogo

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

Parâmetro	Descrição	Exemplo
category_id	Filtra itens pelo ID da categoria da loja	cat-ai-tools
sort	Campo de ordenação: view_count, created_at ou price	price
order	Direção da ordenação: asc ou desc	asc
page	Número da página (iniciando em 1)	1
limit	Itens por página (padrão da loja: 20)	20
locale	Idioma preferido da resposta	pt

{
  "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 de Detalhes do Produto

Use este endpoint ao abrir a página individual de um produto para carregar descrições completas, galeria de imagens, prazo de garantia e termos de entrega.

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. Campos do Esquema de Produto

id

Identificador único do produto usado na consulta de detalhes, carrinho e checkout.

slug

Slug amigável para URL do produto, ex.: /en/accounts/chatgpt-plus.

type

Tipo de rota no catálogo: account ou service.

name_vi / name_en

Títulos do produto traduzidos por idioma.

thumbnail

Imagem principal do card exibida nas páginas de listagem.

inventory_status

Indicador geral de estoque exibido nos cards e na página de detalhes.

categories

Categorias atribuídas para filtragem e agrupamento na vitrine.

variants

Planos/opções de assinatura com preços em VND e USD, preços de tabela, SKU e estoque.

description_vi / description_en

Descrições completas localizadas exibidas na página de detalhes.

images

Imagens ordenadas da galeria na página de detalhes do produto.

delivery_type_vi / delivery_type_en

Método de entrega traduzido exibido nos destaques do produto.

warranty_duration / warranty_unit

Período e unidade de cobertura de garantia por variante.

vietnam_only

Quando true, indica ativação ou uso restrito a clientes no Vietnã.

variant_layout

Modo de layout do seletor de planos: default, matrix_2d ou matrix_3d.

5. Valores de Status de Estoque

in-stock

Disponível para adição imediata ao carrinho e compra.

low-stock

Estoque restante limitado; exibe selo de últimas unidades.

out-of-stock

Temporariamente indisponível; botões de compra desativados.

price = 0

Item sob orçamento ("Sob consulta"); o botão padrão de compra fica oculto.