Teklif Listele

Satıcının teklif (offer) kayıtlarını sayfa sayfa listeler. Sayfa metadata'sı response header'larında döner, body sadece List<QueryOffersResponse> içerir.

GET/v1/offersscope:OffersRead

Query parametreleri

Parametre	Tip	Zorunlu	Açıklama
`page`	int	evet	Sayfa numarası (>= 1)
`pageSize`	int	evet	Sayfa büyüklüğü (10-100)
`orderBy`	string	evet	`CreatedAt`, `UpdatedAt`, `Price`, `Quantity`
`order`	enum	evet	`Asc` veya `Desc`
`isActive`	bool	opsiyonel	Aktif/pasif filtre
`allowBackorder`	bool	opsiyonel	Backorder destekleyenler
`updatedAtFrom`	datetime	opsiyonel	Bu zamandan sonra güncellenenler (polling için)
`updatedAtTo`	datetime	opsiyonel	Pencere üst sınırı

Örnek istek

curl "https://public-api.epinpark.com/v1/offers?page=1&pageSize=20&orderBy=UpdatedAt&order=Desc&isActive=true" \
  -H "X-Api-Key: $KEY" \
  -H "X-Timestamp: $TS" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIG"

Yanıt

200 OK

X-Total-Count: 142
X-Page: 1
X-Page-Size: 20
X-Next-Page: 2
Content-Type: application/json

Body

[
  {
    "id": "01H8M2K6X7P9...",
    "variantId": "01H8L9M1...",
    "productName": "Steam 100 TL Cüzdan Kodu",
    "sku": "STEAM-WALLET-100",
    "price": 100.00,
    "discountedPrice": 95.00,
    "quantity": 250,
    "isActive": true,
    "allowBackorder": false,
    "createdAt": "2026-04-12T08:24:11.000Z",
    "updatedAt": "2026-05-10T14:02:33.000Z"
  }
]

Hata kodları

Code	Anlam
`400`	Validation hatası (eksik/yanlış parametre)
`401`	HMAC imza geçersiz
`403`	`OffersRead` scope eksik
`429`	Hız limiti aşıldı

Polling için

Senkronizasyon job'ı için orderBy=UpdatedAt&order=Asc&updatedAtFrom={lastSync} kullanın. Polling Deseni sayfasına bakın.