Dapatkan satu produk berdasarkan ID

Metode ini memungkinkan Anda untuk mengambil satu produk berdasarkan ID numeriknya, mengembalikan objek produk lengkap termasuk atribut, harga, dan konten yang dilokalisasi.

✅ Tujuan skenario:

• Mengambil satu produk berdasarkan ID numeriknya
• Mengakses harga produk dan judul yang dilokalisasi
• Membaca nilai atribut seperti mata uang dari produk

✅ Apa yang Anda butuhkan:

• PROJECT_URL dan APP_TOKEN yang valid untuk otentikasi dengan API OneEntry.
• ID produk numerik yang diketahui

📌 Penting:

• Contoh-contoh ini tidak mencakup penanganan kesalahan.
• Anda dapat mengelola kesalahan menggunakan blok try-catch atau dengan menggunakan konstruksi seperti await Promise.catch((error) => error).

📚 Lihat di dokumentasi:

• Katalog

📦 Referensi SDK:

• Produk

Coba secara langsung

Jalankan metode ini secara interaktif di JS SDK sandbox — sambungkan Project URL dan App Token Anda pada kunjungan pertama, lalu buka:

• Dapatkan satu produk berdasarkan ID — Metode ini memungkinkan Anda untuk mengambil satu produk berdasarkan ID numeriknya, mengembalikan objek produk lengkap termasuk atribut, harga, dan konten yang dilokalisasi.

Skenario

1. Impor defineOneEntry dari SDK dan definisikan PROJECT_URL dan APP_TOKEN

Contoh:

import { defineOneEntry } from 'oneentry';
import { IAttributeValues } from 'oneentry/dist/base/utils';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. Membuat klien API dengan defineOneEntry()

Contoh:

const { Products } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Panggil Products.getProductById() dengan metode getProductById()

Contoh:

const product = await Products.getProductById(15, 'en_US');

if ('statusCode' in product) {
  throw new Error(product.message);
}

Hasil:

{
  "id": 15,
  "attributeSetIdentifier": "product",
  "localizeInfos": {
    "title": "Orange ball"
  },
  "statusLocalizeInfos": {},
  "isVisible": true,
  "statusIdentifier": null,
  "position": 1,
  "templateIdentifier": null,
  "shortDescTemplateIdentifier": null,
  "price": 400,
  "additional": {
    "prices": {
      "min": 100,
      "max": 999
    }
  },
  "sku": null,
  "isSync": true,
  "categories": [
    "products"
  ],
  "paymentStages": null,
  "rating": {},
  "attributeValues": {
    "price": {
      "type": "real",
      "value": "400",
      "isIcon": false,
      "position": 0,
      "additionalFields": {},
      "isProductPreview": false
    },
    "currency": {
      "type": "string",
      "value": "USD",
      "isIcon": false,
      "position": 1,
      "additionalFields": {},
      "isProductPreview": false
    },
    "image": {
      "type": "image",
      "value": [],
      "isIcon": false,
      "position": 2,
      "additionalFields": {},
      "isProductPreview": true
    }
  },
  "productPages": [
    {
      "id": 17,
      "pageId": 49,
      "productId": 15,
      "positionId": 1287,
      "categoryPath": "products"
    }
  ],
  "blocks": [],
  "moduleFormConfigs": [],
  "discountConfig": {}
}

4. Akses bidang produk

Contoh:

const title = product.localizeInfos?.title;
const price = product.price;
const attrs = product.attributeValues as IAttributeValues;
const currency = attrs.currency?.value;

console.log('Product: ', product);
console.log('Title: ', title);
console.log('Price: ', price);
console.log('Currency: ', currency);

Hasil:

{
  "product": {
    "id": 15,
    "attributeSetIdentifier": "product",
    "localizeInfos": {
      "title": "Orange ball"
    },
    "statusLocalizeInfos": {},
    "isVisible": true,
    "statusIdentifier": null,
    "position": 1,
    "templateIdentifier": null,
    "shortDescTemplateIdentifier": null,
    "price": 400,
    "additional": {
      "prices": {
        "min": 100,
        "max": 999
      }
    },
    "sku": null,
    "isSync": true,
    "categories": [
      "products"
    ],
    "paymentStages": null,
    "rating": {},
    "attributeValues": {
      "price": {
        "type": "real",
        "value": "400",
        "isIcon": false,
        "position": 0,
        "additionalFields": {},
        "isProductPreview": false
      },
      "currency": {
        "type": "string",
        "value": "USD",
        "isIcon": false,
        "position": 1,
        "additionalFields": {},
        "isProductPreview": false
      },
      "image": {
        "type": "image",
        "value": [],
        "isIcon": false,
        "position": 2,
        "additionalFields": {},
        "isProductPreview": true
      }
    },
    "productPages": [
      {
        "id": 17,
        "pageId": 49,
        "productId": 15,
        "positionId": 1287,
        "categoryPath": "products"
      }
    ],
    "blocks": [],
    "moduleFormConfigs": [],
    "discountConfig": {}
  },
  "title": "Orange ball",
  "price": 400,
  "currency": "USD"
}

Contoh akhir

// 1. Import defineOneEntry from SDK and define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';
import { IAttributeValues } from 'oneentry/dist/base/utils';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. Creating an API client with [defineOneEntry()](/docs/index/#Installation)
const { Products } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Call Products.getProductById() with [getProductById() method](/docs/products/getProductById)
const product = await Products.getProductById(15, 'en_US');

if ('statusCode' in product) {
  throw new Error(product.message);
}

// 4. Access product fields
const title = product.localizeInfos?.title;
const price = product.price;
const attrs = product.attributeValues as IAttributeValues;
const currency = attrs.currency?.value;

console.log('Product: ', product);
console.log('Title: ', title);
console.log('Price: ', price);
console.log('Currency: ', currency);