Sayfalama alanları
| Alan | Nerede | Açıklama |
|---|---|---|
| page | pagination girdisi | Getirilecek sayfa; varsayılan 1 |
| limit | pagination girdisi | Sayfa başına kayıt; 1 ile 200 arası, varsayılan 50 |
| data | Yanıt | Kayıtların listesi |
| hasNext | Yanıt | Bu sayfadan sonra kayıt var mı |
| count | Yanıt | Bu sayfada dönen kayıt sayısı |
Dikkat: ikas'ın tanımına göre count toplam kayıt sayısı değil, istenen sayfada dönen kayıt sayısıdır. Toplamı bilmek için sayfaları hasNext false olana kadar okuyun.
Tüm kayıtları alma
ikas'ın önerdiği yol basittir: page değerini 1'den başlatın ve hasNext false olana kadar artırın (ikas: Sayfalama).
- Sayfa boyutunu yüksek tutun; 200'e kadar çıkabilirsiniz.
- Dönen liste boşsa hasNext'e bakmadan durun; sonsuz döngüye karşı bir üst sayfa sınırı koyun.
- Sayfalar arasında kısa bir bekleme bırakın; 10 saniyede 50 istek sınırını aşmayın.
- Uzun okumalarda veri değişebilir; kritik kararları kimlik bazında yeniden doğrulayın.
- Okuduğunuz son sayfa numarasını kaydedin; bir hatadan sonra baştan değil, kaldığınız yerden devam edersiniz.
Filtre operatörleri
| Girdi tipi | Operatörler | Örnek alan |
|---|---|---|
| StringFilterInput | eq, ne, in, nin | id, sku, orderNumber |
| DateFilterInput | eq, ne, gt, gte, lt, lte, in, nin | orderedAt, updatedAt |
| Enum filtreleri | eq, ne, in, nin | status, orderPackageStatus |
Tarih değerleri milisaniye cinsinden Unix zaman damgasıdır. Son 24 saatte güncellenen siparişler için updatedAt: { gte: ZAMAN_MS } ile birlikte pagination gönderilir. Saniye cinsinden değer göndermek, 1970'e yakın bir tarih anlamına gelir ve filtre beklenmedik sonuç verir.
Sıralama ve arama
sort argümanı alan adını metin olarak alır. Artan sıralama için alanın adını, azalan için başına eksi koyarak yazın: createdAt en eskiden yeniye, -createdAt en yeniden eskiye. Sıralanabilen alanlar her sorgunun açıklamasında belirtilir.
Bazı liste sorguları serbest metin araması için search argümanı alır. Aramanın hangi alanlarda yapıldığı yine ilgili sorgunun açıklamasındadır. Ürünlerde SKU ya da barkodla kesin eşleşme için sku ve barcodeList filtrelerini kullanmak aramadan daha güvenilirdir.
Sık sorulanlar
ikas API bir sayfada kaç kayıt döndürür?
limit en fazla 200 olabilir; varsayılan 50'dir. Daha fazla kayıt için page değerini artırarak devam edin.
ikas count alanı toplam ürün sayısı mı?
Hayır. ikas'ın tanımına göre count, istenen sayfada dönen kayıt sayısıdır. Toplam için tüm sayfaları okumanız gerekir.
ikas tarih filtresi hangi biçimde?
Milisaniye cinsinden Unix zaman damgası. Örneğin updatedAt: { gte: ZAMAN_MS } belirtilen andan sonra güncellenen kayıtları getirir.
ikas'ta sonuçlar nasıl sıralanır?
sort argümanına alan adını yazın; azalan sıralama için başına eksi koyun. Örneğin -createdAt en yeni kayıtları önce getirir. Sıralanabilen alanlar her sorgunun açıklamasında yazar.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı