Ürün eventleri
product.created, product.updated ve product.deleted — katalog senkronizasyonu ve stok takibi.
| Event | Ne zaman tetiklenir |
|---|---|
product.created | Yeni ü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.
{
"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": []
}{
"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.
"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ışı
| Event | Tekrar |
|---|---|
product.created | Ürün başına bir kez |
product.updated | Her 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',
})),
});
}