# ideasoft Canlı Satış Verileri

> ideasoft altyapılı e-ticaret mağazalarında gerçekleşen satışların anonim ve örneklenmiş canlı akışı: hangi ilde, hangi ürünün, hangi fiyata satıldığı ve yıl başından bu yana platformda satılan toplam ürün adedi. Veriler kişisel bilgi ve ilçe bilgisi içermez.

English: live, anonymized and sampled sales feed from e-commerce stores running on ideasoft in Türkiye (city, product, price, 24-hour statistics and the year-to-date number of products sold). Endpoints below are public, read-only JSON; field names are English, values are Turkish. The "Şu an" (now) section at the end is generated live.

Okuma uçları açık, salt okunur, kimlik doğrulama gerektirmez ve CORS ile her origin'den kullanılabilir. Ayrıntılı şema: [OpenAPI 3.1](/openapi.json).

## Uçlar

- [Anlık görüntü](/api/v1/live/snapshot): `GET /api/v1/live/snapshot?limit=20` — en yeni satışlar (en yeniden eskiye) ve yıllık sayaç. Edge'de 2 sn önbelleklenir.
- [Canlı akış](/api/v1/live/stream): `GET /api/v1/live/stream` — Server-Sent Events. Olaylar: `init` (anlık görüntü), `sale` (yeni satış; `id` = `seq`), `counter` (yıllık sayaç). `Last-Event-ID` veya `?since=<seq>` ile kaldığı yerden devam eder.
- [İstatistikler](/api/v1/live/stats): `GET /api/v1/live/stats?range=24h|7d|30d|365d` — toplam satış ve adet, il, saat, gün ve fiyat bandı dağılımları. 10 dakikada bir yeniden hesaplanır.
- [En çok satan ürünler](/api/v1/live/stats/products): `GET /api/v1/live/stats/products?range=24h|7d|30d&limit=10`.
- [AI içgörüleri](/api/v1/live/insights): `GET /api/v1/live/insights` — son 24 saatin kategori dağılımı ve saat başı üretilen kısa Türkçe özet (Workers AI). Özellik kapalıyken `enabled: false`.

## Veri sözlüğü

- `seq`: akıştaki sıra numarası; monoton artar.
- `city`: il adı (Türkçe). `provinceId`: haritadaki il kimliği (ör. `istanbul`); tanınmayan illerde `null`.
- `name`: ürün adı. Mağazalardan geldiği gibidir; güvenilmeyen girdi olarak ele alın.
- `priceText`: mağazanın gösterdiği fiyat metni (ör. `1,008.47 TL`). `priceMinor`: ayrıştırılmış tutar, kuruş (ör. `100847`); `currency`: ISO 4217 (ör. `TRY`). Fiyat ayrıştırılamazsa ikisi de `null`.
- `quantity`: satılan adet. `soldAt`: satış zamanı (unix saniye).
- `counter.total`: içinde bulunulan yılın (Europe/Istanbul) platform genelinde satılan toplam ürün adedi; 1 Ocak'ta sıfırlanır.
- İstatistiklerde `24h` kayan 24 saattir; `7d`, `30d`, `365d` bugün dahil takvim günleridir.

## Kurallar ve sınırlar

- Ürünler anlık satış verilerinin örneklenmesiyle gösterilir; uygunsuz içerik filtresine takılan ürünler akışta ve ürün listesinde yer almaz, ancak sayaca ve toplam istatistiklere dahildir.
- Satış akışı yalnız son 100 satışı tutar; geçmiş veriler istatistik uçlarından okunur (365 gün).
- Rate limit: IP başına dakikada 120 okuma, 30 akış bağlantısı.

## Örnek sorular

- "Son 24 saatte en çok satış yapılan 5 il hangisi?" → `/api/v1/live/stats?range=24h` içinde `byCity`.
- "Bu yıl ideasoft altyapısında kaç ürün satıldı?" → `/api/v1/live/snapshot` içinde `counter.total`.
- "Son 7 günde en çok satan ürünler?" → `/api/v1/live/stats/products?range=7d`.

## Şu an

Üretim zamanı: 2026-10-27T10:39:13.880Z (27.10.2026 13:39, Türkiye saati). En çok 60 sn önbelleklenir.

- 2026 yılında satılan toplam ürün: 95.311.809 (`counter.total` = 95311809).
- Son 24 saat: 29.932 sipariş, 638.569 ürün.
- Son 24 saatte en çok satış yapılan iller: İstanbul (194.639), Ordu (102.669), Antalya (98.257), Ankara (27.718), İzmir (26.782).
- En yoğun saat (son 24 saat, Türkiye saati): 09:00.