API referansı
Ürünleri listele
GET
/api/v1/urunlerÜrün kataloğunuzu varyant düzeyinde döndürür: stok, fiyat, barkod ve ürün bilgileri.
Sorgu parametreleri
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kok | string | hayır | Yalnız bu ürün koduna ait varyantlar |
sku | string | hayır | Tek bir varyant |
yalniz_stoklu | 1 | hayır | Yalnız satışta ve stoklu varyantlar |
limit | integer | hayır | Sayfa boyu, 1–500 (varsayılan 100) |
imlec | integer | hayır | Önceki yanıttaki sonraki_imlec |
Örnek istek
curl "https://panel.bulutegra.com/api/v1/urunler?yalniz_stoklu=1&limit=500" \
-H "Authorization: Bearer $BULUTEGRA_ANAHTAR"import os, requests
r = requests.get(
"https://panel.bulutegra.com/api/v1/urunler?yalniz_stoklu=1&limit=500",
headers={"Authorization": "Bearer " + os.environ["BULUTEGRA_ANAHTAR"]},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://panel.bulutegra.com/api/v1/urunler?yalniz_stoklu=1&limit=500", {
headers: { Authorization: `Bearer ${process.env.BULUTEGRA_ANAHTAR}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());<?php
$ch = curl_init("https://panel.bulutegra.com/api/v1/urunler?yalniz_stoklu=1&limit=500");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("BULUTEGRA_ANAHTAR")],
]);
$veri = json_decode(curl_exec($ch), true);Yanıt
{
"urunler": [
{
"sku": "ABC-1001|SIYAH|M|",
"kok": "ABC-1001",
"renk": "SIYAH",
"beden": "M",
"barkod": "8680000000017",
"aktif": true,
"stok": 14,
"fiyat": 499.9,
"indirimli_fiyat": 424.9,
"ad": "Örnek Ürün — Pamuklu Tişört",
"marka": "Örnek Marka",
"kategori": "Tişört"
}
],
"adet": 1,
"sonraki_imlec": null
}Alanlar
| Alan | Tür | Açıklama |
|---|---|---|
sku | string | Varyant kodu (KÖK|RENK|BEDEN|) |
kok | string | Ürün (ana) kodu |
renk, beden | string | Varyant öznitelikleri |
barkod | string | Barkod |
aktif | boolean | Satışa açık mı |
stok | integer | Satılabilir stok |
fiyat, indirimli_fiyat | number | Liste ve indirimli fiyat (yoksa null) |
ad, marka, kategori | string | Ürün bilgileri |
Son güncelleme: 2026-10-07