hikiehikieDeveloper Documentation
Eventler

Ürün eventleri

product.created, product.updated ve product.deleted — katalog senkronizasyonu ve stok takibi.

EventNe zaman tetiklenir
product.createdYeni ürün eklendi
product.updatedÜrünün herhangi bir alanı güncellendi (fiyat, stok, durum, varyant…)
product.deletedÜrün silindi

Bu eventler genellikle katalog senkronizasyonu için kullanılır: kendi sitenizde ya da uygulamanızda hikie'deki ürün listesinin bir kopyasını tutuyorsanız, güncel kalmasını sağlar.

Payload

Üç eventin gövdesi aynı yapıdadır.

product.updated — dijital ürün
{
  "productId": "66b1efd21c9a4e0021f3ab77",
  "slug": "vip-paket",
  "title": "VIP Paket",
  "description": "Sunucuda VIP ayrıcalıkları ve özel araç erişimi.",
  "type": "DIGITAL",
  "status": "active",
  "stockQuantity": 100,
  "url": "https://hikie.space/magazam/products/vip-paket",
  "dateCreated": "2026-08-05T08:12:03.000Z",
  "dateUpdated": "2026-08-07T11:42:19.000Z",
  "currency": "TRY",
  "pricing": {
    "price": "249.90",
    "discountedPrice": "199.90"
  },
  "category": ["Üyelikler", "VIP"],
  "media": [
    { "url": "https://cdn.hikie.store/products/vip-paket-1.jpg", "placement": 1 }
  ],
  "variants": [
    {
      "sku": "VIP-30",
      "name": "30 gün",
      "status": "active",
      "stockQuantity": 100,
      "pricing": { "price": "249.90", "discountedPrice": "199.90" }
    },
    {
      "sku": "VIP-90",
      "name": "90 gün",
      "status": "out_of_stock",
      "stockQuantity": 0,
      "pricing": { "price": "649.90", "discountedPrice": null }
    }
  ],
  "items": []
}
product.updated — fiziksel ürün
{
  "productId": "66b1efd21c9a4e0021f3ab88",
  "slug": "deri-ceket",
  "title": "Deri Ceket",
  "description": "El yapımı deri ceket.",
  "type": "PHYSICAL",
  "status": "active",
  "stockQuantity": 12,
  "shippingType": "PAID",
  "shippingData": {
    "singleShippingPrice": "29.90",
    "combinedShippingPrice": "9.90"
  },
  "url": "https://hikie.space/magazam/products/deri-ceket",
  "dateCreated": "2026-08-05T08:12:03.000Z",
  "dateUpdated": "2026-08-07T11:42:19.000Z",
  "currency": "TRY",
  "pricing": {
    "price": "899.90",
    "discountedPrice": null
  },
  "category": ["Giyim"],
  "media": [],
  "variants": [
    {
      "sku": "DC-M",
      "name": "M Beden",
      "status": "active",
      "stockQuantity": 12,
      "pricing": { "price": "899.90", "discountedPrice": null }
    }
  ]
}

shippingType ("FREE" ya da "PAID") yalnızca type "PHYSICAL" iken gelir — dijital üründe kargo kavramı hiç olmadığı için alan null olarak değil, tamamen dışarıda bırakılır.

shippingData, shippingType ile birlikte gelir (yalnızca fiziksel ürün). Gerçek tutarları taşır — singleShippingPrice (tek ürünü tek başına gönderme maliyeti) ve combinedShippingPrice (aynı pakete eklenen her ek ürün için eklenen maliyet). shippingType "FREE" iken null gelir — satıcı ücretsiz kargoya geçmeden önce girdiği eski bir tutar, gerçek bir maliyetmiş gibi bildirilmez.

items, yalnızca dosya/kurs/etkinlik/forum içeriği eklenmiş dijital ürünlerde anlamlıdır (panelde "space" olarak adlandırılan şey). Her zaman bir dizidir — hiçbir şey eklenmemişse boş dizi.

product.updated — kurs içerikli
"items": [
  { "itemId": "6512c1a0...", "title": "Bölüm 1", "type": "chapter" },
  { "itemId": "6512c1a1...", "title": "Ders 1: Giriş", "type": "lesson" },
  { "itemId": "6512c1a2...", "title": "Ders 2: Kurulum", "type": "lesson" }
]

type, ürünün taşıdığı içeriğe göre file, chapter, lesson, event veya forum değerlerinden biridir.

category, ürüne atanmış TÜM kategorilerin İSİMLERİNİN dizisidir — tek bir ana/alt çifti değil. Hiçbir kategori seçilmemişse boş dizi gelir, asla null değil.

Alan

Tip

variants[] alanları

Alan

Tip

Fiyat ve stok gerçeği varyant seviyesindedir. Üst seviyedeki pricing.price ürünün genel fiyatını temsil eder; müşteri hangi varyantı seçtiyse onun fiyatını öder. Sipariş kalemlerindeki variant alanı bu varyantla eşleşir.

product.updated çok sık gelir

Ürünün herhangi bir alanı değiştiğinde üretilir — fiyat, stok, açıklama, görsel sırası, kategori. Yoğun bir mağazada saatte yüzlerce olabilir.

Öneriler:

Snapshot replay

Panelden "mevcut ürünleri yeniden yayınla" dediğinizde, tüm ürünleriniz için birer product.updated gönderilir. Alıcı kendi tarafını sıfırdan senkronlayabilir.

Replay edilen bir product.updated işaretlenmez — payload, o ürün için gerçek bir güncellemenin göndereceğiyle birebir aynıdır. Replay'i tespit etmek için bir bayrağa güvenmeyin; fiyat düşüşü maili, stok uyarısı gibi yan etkileri kendi iş mantığınızla koruyun — örneğin yalnızca önemsediğiniz değer gerçekten sizde kayıtlı olandan farklıysa bildirim gönderin.

async function onProductUpdated(data) {
  const onceki = await db.getProduct(data.productId);
  await db.upsertProduct(data);

  // Bir replay bayrağı değil, sizde kayıtlı olanla karşılaştırın — böylece
  // gerçek bir fiyat düşüşü, tesadüfen bir replay'in hemen ardından gelse
  // bile yine bildirim üretir.
  if (onceki && fiyatDustu(onceki, data)) {
    await notifyWatchers(data.productId);
  }
}

product.deleted

Ürün silindi. Payload silinme anındaki son hâlini taşır.

async function onProductDeleted(data) {
  await db.deleteProduct(data.productId);
  await removeFromStorefront(data.productId);
}

Silinen bir ürünün geçmiş siparişlerdeki kalemleri kaybolmaz. Sipariş geçmişinizde productId üzerinden ürün adı arıyorsanız, silinen ürünlerin adını kendi tarafınızda saklamış olmanız gerekir.

Tekrar davranışı

EventTekrar
product.createdÜrün başına bir kez
product.updatedHer güncellemede bir kez
product.deletedÜrün başına bir kez

Aynı ürün aynı milisaniyede iki kez güncellenirse tek event gider — ikisi de aynı son durumu anlattığı için bu kayıp değildir.

Tam senkronizasyon deseni

async function syncProduct(event) {
  const { data } = event;

  // 1) Sıralama koruması — geciken eski bir event yeniyi ezmesin
  const mevcut = await db.getProduct(data.productId);
  if (mevcut && data.updatedAt && mevcut.updatedAt >= data.updatedAt) {
    return;
  }

  // 2) Silme
  if (eventType === 'product.deleted') {
    return db.deleteProduct(data.productId);
  }

  // 3) Ekleme / güncelleme — created ve updated aynı işlem
  await db.upsertProduct({
    id: data.productId,
    slug: data.slug,
    name: data.title,
    // Satış fiyatı: indirim varsa o, yoksa liste fiyatı
    price: data.pricing.discountedPrice ?? data.pricing.price,
    listPrice: data.pricing.price,
    active: data.status === 'active',
    categories: data.category,
    updatedAt: data.dateUpdated,
    variants: data.variants.map((v) => ({
      sku: v.sku,
      name: v.name,
      price: v.pricing.discountedPrice ?? v.pricing.price,
      stock: v.stockQuantity,
      active: v.status !== 'inactive',
    })),
  });
}

Bu sayfada