Sayfalama
Liste endpoint'leri tek ve öngörülebilir bir şekli takip eder: data
payload'ı {items: [...], total, limit, offset} olan sarmalanmış bir
zarf (bazı endpoint'ler items'ı accounts, notifications vs.
olarak adlandırır, ancak alanlar daima mevcuttur).
Query parametreleri
| Parametre | Tip | Varsayılan | Aralık | Notlar |
|---|---|---|---|---|
limit |
integer | 50 | 1–1000 | Kontrolsüz taramaları önlemek için sıkı agent-tarafı üst sınırı. |
offset |
integer | 0 | ≥ 0 | Sıfır indeksli; sayfalama için limit ile birleştirin. |
sort |
string | endpoint'e özel | endpoint'e özel | Sunucuda typed enum (regex doğrulamalı). |
order |
string | asc |
asc, desc |
Yanıt şekli
JSON
{
"status": "success",
"data": {
"items": [ /* item nesneleri */ ],
"total": 1245,
"limit": 50,
"offset": 0
}
}
Tutarlı crawl semantiği gerektiren partner entegrasyonları için
len(items) < limit olana kadar offset += limit ile ileri sayfalayın.
WHost şu anda cursor tabanlı sayfalama sunmaz; gerekli olursa
/api/v2/ altında eklenecektir.
Hâlâ Yardıma mı İhtiyacınız Var?
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.