Dokumentasi API Produk

API Katalog Produk Baca-Saja untuk Reseller & Mitra.

Referensi ini mendokumentasikan field JSON publik baca-saja yang digunakan pada kartu produk, halaman detail, filter kategori, lencana stok, dan varian harga VND/USD EmpireX. Tidak ada data pribadi yang diekspos.

1. Panduan Cepat

Ambil item katalog aktif melalui endpoint daftar untuk menampilkan kartu produk lengkap dengan gambar mini, judul terlokalisasi, harga VND/USD, diskon, dan ketersediaan stok.

GET /api/accounts

GET /api/services

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

2. API Daftar Katalog

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

Parameter	Deskripsi	Contoh
category_id	Filter produk berdasarkan ID kategori etalase	cat-ai-tools
sort	Kolom pengurutan: view_count, created_at, atau price	price
order	Arah pengurutan: asc atau desc	asc
page	Nomor halaman (dimulai dari 1)	1
limit	Jumlah item per halaman (bawaan toko adalah 20)	20
locale	Kode bahasa respons yang diinginkan	id

{
  "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 Detail Produk

Gunakan endpoint ini saat membuka halaman produk satuan untuk memuat deskripsi lengkap, galeri gambar, masa garansi, dan ketentuan pengiriman.

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. Skema Field Produk

id

Pengidentifikasi unik produk untuk pencarian detail, item keranjang, dan checkout.

slug

Slug URL produk yang ramah pengguna, mis. /en/accounts/chatgpt-plus.

type

Jenis rute katalog: account atau service.

name_vi / name_en

Judul produk dalam berbagai bahasa.

thumbnail

Gambar kartu utama yang ditampilkan pada halaman daftar katalog.

inventory_status

Indikator stok tingkat utama pada kartu dan halaman detail.

categories

Kategori yang ditetapkan untuk penyaringan dan pengelompokan etalase.

variants

Pilihan paket/langganan beserta harga VND & USD, harga coret, kode SKU, dan stok.

description_vi / description_en

Deskripsi lengkap produk multibahasa pada halaman detail.

images

Daftar terurut gambar galeri produk pada halaman detail.

delivery_type_vi / delivery_type_en

Metode pengiriman terlokalisasi pada sorotan produk.

warranty_duration / warranty_unit

Durasi dan satuan masa garansi per varian produk.

vietnam_only

Jika bernilai true, menandakan aktivasi atau penggunaan khusus wilayah Vietnam.

variant_layout

Mode tata letak pemilih varian: default, matrix_2d, atau matrix_3d.

5. Nilai Status Ketersediaan

in-stock

Tersedia untuk langsung ditambahkan ke keranjang dan checkout.

low-stock

Sisa stok terbatas; menampilkan lencana stok menipis.

out-of-stock

Tidak tersedia sementara; tombol pembelian dinonaktifkan.

price = 0

Produk khusus penawaran harga (“Hubungi untuk penawaran”); tombol beli standar disembunyikan.