Dokümantasyon · API

API örnekleri

Tüm response'lar `@ederli/schemas` Zod şemaları ile parse edilir — runtime'da `any` görmezsiniz.

Public

GET/v1/products/featured

Öne çıkan ürünler

Anasayfada gösterilen 8 ürün — ISR cache 10 dakika.

Response

{
  "data": [
    {
      "id": "uuid…",
      "slug": "iphone-15-pro-128gb",
      "title": "iPhone 15 Pro 128 GB",
      "lowestPrice": {
        "amount": 58900,
        "currency": "TRY"
      }
    }
  ],
  "nextCursor": null
}

Pricing

GET/v1/pricing/{productId}/history?window=30d

Fiyat geçmişi

30/90/365 günlük fiyat geçmişi + min/max/median stats.

Response

{
  "productId": "uuid…",
  "window": "30d",
  "series": [
    "…30 nokta…"
  ],
  "stats": {
    "current": {
      "amount": 58900,
      "currency": "TRY"
    },
    "min": {
      "amount": 54000,
      "currency": "TRY"
    }
  }
}

POST/v1/pricing/alerts

Fiyat alarmı kur

Hedef fiyat veya yüzde düşüş alarmı.

Headers

{
  "authorization": "Bearer <jwt>"
}

Request body

{
  "productId": "uuid…",
  "target": {
    "amount": 55000,
    "currency": "TRY"
  },
  "channels": [
    "push",
    "email"
  ]
}

Response

{
  "id": "uuid…",
  "createdAt": "2026-…",
  "active": true
}

Cart

POST/v1/cart/add

Sepete ekle

Optimistic UI ile sepete ekle. Sunucu canonical cart'ı döner.

Request body

{
  "offerId": "uuid…",
  "qty": 1
}

Response

{
  "id": "uuid…",
  "lines": [],
  "total": {
    "amount": 0,
    "currency": "TRY"
  }
}

Q&A

POST/v1/qa/questions
Soru gönder
Topluluk Q&A'a soru gönder. Spam ML skoru ≥ 0.92 → otomatik reject.
Request body
```
{
  "productId": "uuid…",
  "body": "Türkiye garantisi var mı?",
  "topic": "garanti"
}
```

Geo

GET/api/public/map/nearby?lat=41.0082&lng=28.9784&radius_km=10
Yakındaki satıcılar
Konuma göre en yakın satıcılar — distance × price × trust blended ranking.
GET/api/public/map/delivery-check?lat=…&lng=…&product_id=…
Teslimat kontrolü
Bu adrese hangi satıcı kargo + BOPIS sunuyor?

Public

GET/v1/products/featured

Öne çıkan ürünler

Anasayfada gösterilen 8 ürün — ISR cache 10 dakika.

Response

{
  "data": [
    {
      "id": "uuid…",
      "slug": "iphone-15-pro-128gb",
      "title": "iPhone 15 Pro 128 GB",
      "lowestPrice": {
        "amount": 58900,
        "currency": "TRY"
      }
    }
  ],
  "nextCursor": null
}

Pricing

GET/v1/pricing/{productId}/history?window=30d

Fiyat geçmişi

30/90/365 günlük fiyat geçmişi + min/max/median stats.

Response

{
  "productId": "uuid…",
  "window": "30d",
  "series": [
    "…30 nokta…"
  ],
  "stats": {
    "current": {
      "amount": 58900,
      "currency": "TRY"
    },
    "min": {
      "amount": 54000,
      "currency": "TRY"
    }
  }
}

POST/v1/pricing/alerts

Fiyat alarmı kur

Hedef fiyat veya yüzde düşüş alarmı.

Headers

{
  "authorization": "Bearer <jwt>"
}

Request body

{
  "productId": "uuid…",
  "target": {
    "amount": 55000,
    "currency": "TRY"
  },
  "channels": [
    "push",
    "email"
  ]
}

Response

{
  "id": "uuid…",
  "createdAt": "2026-…",
  "active": true
}