Doc API Produits

API catalogue produits en lecture seule pour revendeurs & partenaires.

Cette documentation décrit les champs JSON publics en lecture seule qui alimentent les cartes produits, fiches détaillées, filtres de catégories, badges de stock et variantes tarifaires VND/USD d’EmpireX. Aucune donnée privée n’est exposée.

1. Démarrage rapide

Récupérez les articles actifs via les endpoints de liste afin d’afficher des cartes boutique comprenant vignettes, titres localisés, prix VND/USD, remises et disponibilité.

GET /api/accounts

GET /api/services

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

2. API Liste du catalogue

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

Paramètre	Description	Exemple
category_id	Filtrer les articles par identifiant de catégorie boutique	cat-ai-tools
sort	Champ de tri : view_count, created_at ou price	price
order	Ordre de tri : asc ou desc	asc
page	Numéro de page (commence à 1)	1
limit	Articles par page (20 par défaut sur la boutique)	20
locale	Langue souhaitée pour la réponse	fr

{
  "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 Détail produit

Utilisez cet endpoint lors de l’ouverture d’une fiche produit afin de charger la description complète, la galerie d’images, la durée de garantie et le mode de livraison.

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. Champs du schéma produit

id

Identifiant unique du produit utilisé pour le détail, le panier et le paiement.

slug

Slug URL convivial du produit, ex. /fr/accounts/chatgpt-plus.

type

Type de route du catalogue : account ou service.

name_vi / name_en

Titres du produit traduits selon la langue.

thumbnail

Image principale affichée sur les listes du catalogue.

inventory_status

Indicateur principal de disponibilité sur les cartes et fiches produit.

categories

Catégories associées pour le filtrage et le regroupement en boutique.

variants

Formules et options d’abonnement avec tarifs VND & USD, prix barrés, SKU et stock.

description_vi / description_en

Descriptions riches localisées affichées sur la fiche produit.

images

Galerie d’images ordonnée sur la page de détail du produit.

delivery_type_vi / delivery_type_en

Mode de livraison localisé affiché dans les points clés du produit.

warranty_duration / warranty_unit

Durée et unité de garantie propres à chaque variante.

vietnam_only

Lorsque la valeur vaut true, indique une activation ou utilisation réservée au Vietnam.

variant_layout

Mode d’affichage du sélecteur de variantes : default, matrix_2d ou matrix_3d.

5. Valeurs d’état de stock

in-stock

Disponible immédiatement pour l’ajout au panier et le paiement.

low-stock

Stock restant limité ; affiche un badge de stock faible.

out-of-stock

Temporairement indisponible ; les boutons d’achat sont désactivés.

price = 0

Article sur devis (« Demander un devis ») ; le bouton d’achat standard est masqué.